GitHub - AgriciDaniel/claude-seo: Universal SEO skill for Claude Code. 19 sub-skills, 12 subagents, 3 extensions (DataForSEO, Firecrawl, Banana). Technical SEO, E-E-A-T, schema, GEO/AEO, backlinks, local SEO, maps intelligence, Google APIs, and PDF/Excel reporting.
핵심 포인트
- 1Claude SEO는 Claude Code를 위한 종합적인 SEO 분석 및 최적화 skill로, 기술 SEO부터 콘텐츠 품질(E-E-A-T), 스키마 마크업, AI search optimization(GEO) 등 광범위한 기능을 제공합니다.
- 2이 도구는 Google Search Console, PageSpeed Insights, CrUX, GA4 등 Google SEO API와의 직접 연동을 통해 심층적인 데이터를 활용하고, PDF 보고서 생성을 지원하여 전략적 SEO planning을 돕습니다.
- 3또한, DataForSEO 및 Banana(AI Image Generation)와 같은 외부 확장을 통해 기능을 확장하고, Claude Code ecosystem 내 다른 skill들과 연동되어 SEO 전문가를 위한 통합적이고 다재다능한 작업 환경을 구축합니다.
Claude SEO는 Claude Code를 위한 포괄적인 SEO 분석 및 감사 스킬입니다. 이는 기술 SEO, 온페이지(On-Page) 분석, 콘텐츠 품질(E-E-A-T), 스키마 마크업, 이미지 최적화, 사이트맵 아키텍처, AI 검색 최적화(GEO), 로컬 SEO, 지도 인텔리전스, Google SEO API 연동(Search Console, PageSpeed, CrUX, GA4), PDF 보고서 생성 및 전략적 SEO 플래닝 등 광범위한 기능을 제공합니다.
핵심 기능 및 방법론:
Claude SEO는 다양한 하위 명령어와 서브 에이전트(subagents)를 통해 기능합니다. 주요 기능은 다음과 같습니다:
- 종합 웹사이트 감사 (): 병렬 서브 에이전트 위임을 통해 전체 웹사이트에 대한 심층 감사를 수행합니다.
- 단일 페이지 분석 (): 특정 웹 페이지에 대한 상세 분석을 제공합니다.
- 스키마 마크업 관리 ():
- 탐지 및 유효성 검사: JSON-LD(선호), Microdata, RDFa를 포함한 다양한 스키마 유형을 탐지하고 유효성을 검사합니다.
- 생성: 산업 표준 템플릿을 사용하여 새로운 스키마 마크업을 생성합니다.
- 지원 및 폐기 업데이트: 최신 Google 가이드라인을 반영하여 HowTo (2023년 9월 폐기), FAQ (2023년 8월 정부/보건 사이트 제한), SpecialAnnouncement (2025년 7월 폐기)와 같은 폐기 예정 스키마를 인지합니다.
- Video & Live Schema:
VideoObject,BroadcastEvent,Clip,SeekToAction,SoftwareSourceCode와 같은 비디오 콘텐츠 및 라이브 스트리밍을 위한 추가 스키마 유형을 지원합니다.
- 이미지 최적화 (): 이미지 사용 및 최적화에 대한 분석을 제공합니다.
- 기술 SEO 감사 (): 9가지 범주에 걸쳐 기술 SEO 문제를 진단합니다.
- 콘텐츠 품질 분석 ():
- E-E-A-T 분석: 2025년 9월 Quality Rater Guidelines에 따라 Experience (직접 경험), Expertise (전문성), Authoritativeness (권위), Trustworthiness (신뢰성)를 기반으로 콘텐츠 품질을 평가합니다.
- AI 검색 최적화(GEO) (): 2026년을 목표로 Google AI Overviews, ChatGPT 웹 검색, Perplexity 등 AI 기반 검색 엔진에 최적화하는 전략을 수립합니다.
- 전략적 SEO 플래닝 (): SaaS, 로컬 비즈니스, 이커머스, 퍼블리셔, 에이전시 등 다양한 비즈니스 모델에 맞는 SEO 전략을 제시합니다.
- 프로그래매틱 SEO (
/seo programmatic [url|plan]): 대량의 데이터 기반 페이지 생성 및 관리를 지원합니다. 얇은 콘텐츠(thin content) 및 캐니벌리제이션(cannibalization) 분석, URL 패턴 및 템플릿 구조 계획, 내부 링크 자동화, 캐노니컬(canonical) 전략 및 인덱스 블로트(index bloat) 방지 기능을 포함하며, 100페이지 이상 시 경고, 500페이지 이상 시 감사 없이는 중단되는 품질 게이트(Quality Gates)를 적용합니다. - 경쟁사 비교 페이지 생성 (
/seo competitor-pages [url|generate]): "X vs Y" 또는 "alternatives to X"와 같은 고전환 비교 페이지 생성을 자동화합니다. 특징 매트릭스가 포함된 구조화된 비교 테이블,Product스키마 마크업, 전환 최적화된 레이아웃, 경쟁 의도 쿼리(comparison intent queries)를 위한 키워드 타겟팅, 공정성 가이드라인을 준수합니다. - Hreflang / i18n SEO 감사 및 생성 (): 다국어 사이트의
hreflang태그를 검증하고 생성합니다. HTML, HTTP 헤더, XML 사이트맵을 통해hreflang태그를 생성하고, 자체 참조 태그, 반환 태그,x-default를 검증하며, 누락된 반환, 유효하지 않은 코드, HTTP/HTTPS 불일치와 같은 일반적인 실수를 탐지합니다. 교차 도메인hreflang지원 및 언어/지역 코드(ISO 639-1 + ISO 3166-1) 유효성 검사를 수행합니다. - Google SEO API 연동 (
/seo google [command] [url]):- PageSpeed Insights + CrUX: 랩(Lab) 및 필드(Field) Core Web Vitals 데이터를 제공합니다.
- Core Web Vitals:
LCP(Largest Contentful Paint) 목표 ,INP(Interaction to Next Paint) 목표 ,CLS(Cumulative Layout Shift) 목표 입니다. INP는 2024년 3월 12일 FID를 대체했으며, FID는 2024년 9월 9일 모든 Chrome 도구에서 완전히 제거되었습니다.
- Core Web Vitals:
- Search Console: 상위 쿼리, URL 검사, 사이트맵 상태를 조회합니다.
- Indexing API: 새로운/업데이트된/제거된 URL을 Google에 통지합니다.
- GA4: 유기적 트래픽, 상위 랜딩 페이지, 장치/국가별 분석을 제공합니다.
- PDF 보고서:
WeasyPrint와matplotlib를 사용하여 차트가 포함된 엔터프라이즈 A4 PDF 보고서(예: CWV 감사, GSC 성과)를 생성합니다. 4단계 자격 증명 시스템을 통해 API 키, OAuth/SA, GA4 설정, Ads 토큰에 따라 다양한 데이터 접근 권한을 가집니다.
- PageSpeed Insights + CrUX: 랩(Lab) 및 필드(Field) Core Web Vitals 데이터를 제공합니다.
- 로컬 SEO 및 지도 인텔리전스 (,
/seo maps [command]): Google Business Profile 최적화, NAP(Name, Address, Phone number) 일관성 감사, 인용 및 리뷰 분석, 지오-그리드(geo-grid) 순위 추적, 경쟁사 반경 매핑 등을 포함합니다. 30개 이상 로컬 페이지 경고, 50개 이상 로컬 페이지는 강제 중단하는 품질 게이트를 적용합니다.
아키텍처 및 확장성:
Claude SEO는 ~/.claude/skills/seo/ 경로의 메인 오케스트레이터 스킬로 작동하며, ~/.claude/skills/seo-*/에 위치한 15개 이상의 서브 스킬과 2개의 확장(extensions)으로 구성됩니다. 또한 ~/.claude/agents/seo-*.md에 정의된 10개 이상의 서브 에이전트가 작업을 위임받아 수행합니다.
MCP(Message Control Protocol) 통합:
이 시스템은 MCP 서버와 통합되어 Ahrefs, Semrush, Google Search Console, PageSpeed Insights, DataForSEO와 같은 서비스로부터 실시간 SEO 데이터를 가져올 수 있습니다. 이는 확장(extensions)을 통해 외부 데이터 소스와의 연동을 가능하게 합니다.
- DataForSEO 확장: 라이브 SERP 데이터, 키워드 연구, 백링크, 온페이지 분석, 콘텐츠 분석, 비즈니스 리스팅, AI 가시성 확인, LLM 언급 추적 등 9개 API 모듈에 걸친 22개 명령을 제공합니다.
- Banana (AI 이미지 생성) 확장: Claude Banana Creative Director 파이프라인을 사용하여 OG 미리보기, 블로그 히어로, 제품 사진, 인포그래픽 등 SEO에 최적화된 이미지를 생성합니다.
생태계:
Claude SEO는 Claude Code 생태계의 일부로, 다음과 같은 다른 스킬들과 연동됩니다:
- Claude Blog: 블로그 작성, 최적화, 스코어링 (SEO 분석 결과에 따라 콘텐츠 작성).
- Claude Banana: Gemini를 통한 AI 이미지 생성 (SEO 자산 및 블로그 게시물용 이미지 생성).
- AI Marketing: 카피라이팅, 이메일, 소셜, 광고, 퍼널, CRO (SEO 감사 후 마케팅 실행).
전반적으로 Claude SEO는 Google의 최신 업데이트 및 AI 검색 트렌드를 반영하여 광범위하고 심층적인 SEO 분석 및 전략 수립 기능을 제공하는 강력한 도구입니다.