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.
Service

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.

AgriciDaniel
2026.04.10
·GitHub·by 이호민
#Agent#AI#Claude#Code#SEO

핵심 포인트

  • 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)를 통해 기능합니다. 주요 기능은 다음과 같습니다:

  1. 종합 웹사이트 감사 (/seoaudit<url>/seo audit <url>): 병렬 서브 에이전트 위임을 통해 전체 웹사이트에 대한 심층 감사를 수행합니다.
  2. 단일 페이지 분석 (/seopage<url>/seo page <url>): 특정 웹 페이지에 대한 상세 분석을 제공합니다.
  3. 스키마 마크업 관리 (/seoschema<url>/seo schema <url>):
    • 탐지 및 유효성 검사: JSON-LD(선호), Microdata, RDFa를 포함한 다양한 스키마 유형을 탐지하고 유효성을 검사합니다.
    • 생성: 산업 표준 템플릿을 사용하여 새로운 스키마 마크업을 생성합니다.
    • 지원 및 폐기 업데이트: 최신 Google 가이드라인을 반영하여 HowTo (2023년 9월 폐기), FAQ (2023년 8월 정부/보건 사이트 제한), SpecialAnnouncement (2025년 7월 폐기)와 같은 폐기 예정 스키마를 인지합니다.
    • Video & Live Schema: VideoObject, BroadcastEvent, Clip, SeekToAction, SoftwareSourceCode와 같은 비디오 콘텐츠 및 라이브 스트리밍을 위한 추가 스키마 유형을 지원합니다.
  4. 이미지 최적화 (/seoimages<url>/seo images <url>): 이미지 사용 및 최적화에 대한 분석을 제공합니다.
  5. 기술 SEO 감사 (/seotechnical<url>/seo technical <url>): 9가지 범주에 걸쳐 기술 SEO 문제를 진단합니다.
  6. 콘텐츠 품질 분석 (/seocontent<url>/seo content <url>):
    • E-E-A-T 분석: 2025년 9월 Quality Rater Guidelines에 따라 Experience (직접 경험), Expertise (전문성), Authoritativeness (권위), Trustworthiness (신뢰성)를 기반으로 콘텐츠 품질을 평가합니다.
  7. AI 검색 최적화(GEO) (/seogeo<url>/seo geo <url>): 2026년을 목표로 Google AI Overviews, ChatGPT 웹 검색, Perplexity 등 AI 기반 검색 엔진에 최적화하는 전략을 수립합니다.
  8. 전략적 SEO 플래닝 (/seoplan<type>/seo plan <type>): SaaS, 로컬 비즈니스, 이커머스, 퍼블리셔, 에이전시 등 다양한 비즈니스 모델에 맞는 SEO 전략을 제시합니다.
  9. 프로그래매틱 SEO (/seo programmatic [url|plan]): 대량의 데이터 기반 페이지 생성 및 관리를 지원합니다. 얇은 콘텐츠(thin content) 및 캐니벌리제이션(cannibalization) 분석, URL 패턴 및 템플릿 구조 계획, 내부 링크 자동화, 캐노니컬(canonical) 전략 및 인덱스 블로트(index bloat) 방지 기능을 포함하며, 100페이지 이상 시 경고, 500페이지 이상 시 감사 없이는 중단되는 품질 게이트(Quality Gates)를 적용합니다.
  10. 경쟁사 비교 페이지 생성 (/seo competitor-pages [url|generate]): "X vs Y" 또는 "alternatives to X"와 같은 고전환 비교 페이지 생성을 자동화합니다. 특징 매트릭스가 포함된 구조화된 비교 테이블, Product 스키마 마크업, 전환 최적화된 레이아웃, 경쟁 의도 쿼리(comparison intent queries)를 위한 키워드 타겟팅, 공정성 가이드라인을 준수합니다.
  11. Hreflang / i18n SEO 감사 및 생성 (/seohreflang<url>/seo hreflang <url>): 다국어 사이트의 hreflang 태그를 검증하고 생성합니다. HTML, HTTP 헤더, XML 사이트맵을 통해 hreflang 태그를 생성하고, 자체 참조 태그, 반환 태그, x-default를 검증하며, 누락된 반환, 유효하지 않은 코드, HTTP/HTTPS 불일치와 같은 일반적인 실수를 탐지합니다. 교차 도메인 hreflang 지원 및 언어/지역 코드(ISO 639-1 + ISO 3166-1) 유효성 검사를 수행합니다.
  12. Google SEO API 연동 (/seo google [command] [url]):
    • PageSpeed Insights + CrUX: 랩(Lab) 및 필드(Field) Core Web Vitals 데이터를 제공합니다.
      • Core Web Vitals: LCP (Largest Contentful Paint) 목표 <2.5s< 2.5s, INP (Interaction to Next Paint) 목표 <200ms< 200ms, CLS (Cumulative Layout Shift) 목표 <0.1< 0.1입니다. INP는 2024년 3월 12일 FID를 대체했으며, FID는 2024년 9월 9일 모든 Chrome 도구에서 완전히 제거되었습니다.
    • Search Console: 상위 쿼리, URL 검사, 사이트맵 상태를 조회합니다.
    • Indexing API: 새로운/업데이트된/제거된 URL을 Google에 통지합니다.
    • GA4: 유기적 트래픽, 상위 랜딩 페이지, 장치/국가별 분석을 제공합니다.
    • PDF 보고서: WeasyPrintmatplotlib를 사용하여 차트가 포함된 엔터프라이즈 A4 PDF 보고서(예: CWV 감사, GSC 성과)를 생성합니다. 4단계 자격 증명 시스템을 통해 API 키, OAuth/SA, GA4 설정, Ads 토큰에 따라 다양한 데이터 접근 권한을 가집니다.
  13. 로컬 SEO 및 지도 인텔리전스 (/seolocal<url>/seo local <url>, /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 분석 및 전략 수립 기능을 제공하는 강력한 도구입니다.