25개 서브스킬·18개 전문 에이전트로 10–15분 만에 사이트 감사 워크플로
Claude Code용 오픈소스 SEO 스킬로 병렬 에이전트를 통해 전체 사이트 감사를 자동화해 우선순위화된 마크다운·PDF 리포트를 출력한다.
TL;DR
Claude SEO는 Claude Code용 오픈소스 SEO 스킬로서 25개의 서브스킬과 18개의 전문 에이전트를 병렬로 실행해 사이트 전반을 자동 감사하고 우선순위화된 마크다운과 PDF 리포트를 생성한다. 오케스트레이터가 최대 15개의 하위 에이전트를 동시 실행해 감사 시간을 분 단위로 단축하며 Playwright 기반 렌더링과 CrUX·PageSpeed 통합으로 실무 지표를 보완한다. 기본 작동은 로컬 우선이며 Google API와 MCP 확장을 단계적으로 연결해 필드 데이터를 추가로 확보할 수 있고 각 권고에는 실패 판정 기준과 선행 지표가 포함돼 검증 가능성이 높다. 제한점으로는 특정 스크롤 바인딩 또는 사용자 상호작용 후 로드되는 애플리케이션에서 노이즈가 발생할 수 있고 무료 모드에서는 외부 API 없이 랩 추정치로 대체된다는 점이 있다.
주요 기능
- 실행한다. 전체 사이트 감사를 /seo audit 명령으로 시작하면 오케스트레이터가 최대 15개의 전문 에이전트를 병렬 디스패치해 기술·콘텐츠·스키마 검사를 동시에 수행한다. 결과는 합산 점수와 우선순위화된 액션 플랜으로 수렴해 마크다운과 PDF로 출력된다.
- 생성한다. 스키마 감지와 JSON-LD 생성기를 제공해 Organization, Product, LocalBusiness 등 여러 타입의 마크업을 탐지하고 보완용 생성물을 만든다. 생성된 마크업은 Rich Results Test와 Schema Markup Validator 규칙을 준거로 검증 보고서를 함께 출력한다.
- 평가한다. E-E-A-T와 AI 검색 적합성 지표를 결합해 경험·전문성·권위·신뢰성 축을 계량화하고 passage citability와 heading 구조, 인용 밀도를 점수화한다. 평가 결과는 실패 모드와 선행 지표를 포함한 검증 가능한 권고 항목으로 표현된다.
- 통합한다. 선택적 MCP 확장과 Google API 계층을 통해 PageSpeed Insights, CrUX, Search Console, GA4 같은 필드 데이터를 단계적으로 병합한다. 모든 자격증명은 로컬 설정 아래에 제한 권한으로 저장되며 기본 작동은 API 없이도 가능하다.
어떻게 동작하는가
오케스트레이터가 skills 디렉토리를 자동 발견하고 SKILL.md 기반으로 서브스킬과 에이전트를 등록해 작동한다. /seo audit 명령이 들어오면 최대 15개의 하위 에이전트를 병렬로 실행해 각 축별 신호를 수집하고 내부 스코어링 엔진이 의존성 그래프와 10원칙 프레임워크에 따라 권고를 합성한다. SPA 처리가 필요한 페이지는 Playwright 기반의 headless rendering를 통해 렌더된 DOM을 추출하고 최종 리포트는 마크다운과 WeasyPrint로 PDF로 출력된다.
해결 문제
수작업 기반의 불규칙한 사이트 감사에서 발생하는 시간 지연과 일관성 문제를 자동화해 해결한다. 대규모 고객 포트폴리오를 가진 에이전시나 반복 감사가 필요한 팀이 수 시간에서 매주 반복 가능한 체크리스트로 전환할 수 있도록 감사를 분해해 병렬로 실행한다. 또한 스키마 폐지·AI 검색 적합성 같은 최신 검색 변화에 대한 탐지와 검증 가능한 권고를 제공해 운영 리스크를 낮춘다.
지금 주목받는 이유
AI 검색 노출과 구글 AI 최적화 가이드에 맞춘 감사가 산업의 관심을 받고 있고 v2에서 대규모 기능 확장과 MCP 통합이 이루어져 주목을 받았다. 오픈소스 라이선스와 Claude Code 에코시스템 내 네이티브 플러그인 경험이 결합돼 실무 적용 장벽이 낮아진 상태이다. 리포지토리의 높은 스타 수와 다양한 확장 연계가 채택을 가속화하는 요인으로 작용한다.
차별점
- 로컬 우선의 오픈소스 모델을 제공한다. 기본 모드는 외부 API 없이 작동하며 선택적 MCP 확장과 Google API 업그레이드로 필드 데이터를 단계적으로 통합할 수 있다. 이로 인해 데이터가 기본적으로 외부로 유출되지 않는 배포 모델을 유지한다.
- 권고의 가설 검증 요소를 표준으로 포함한다. 모든 권고에는 근거 관찰·의존 관계·실패 판정 기준·선행 지표가 첨부되어 권고가 검증 가능하도록 구성되어 있다. 이 구조는 고객 보고와 기술적 후속 조치에서 책임 추적을 쉽게 만든다.
- 병렬 서브에이전트 아키텍처를 통해 전체 사이트 감사를 단축한다. 오케스트레이터가 최대 15개의 전문 에이전트를 동시 실행해 수집과 분석을 분리하며 이로 인해 전체 감사 시간이 분 단위로 줄어든다. SPA 처리와 CrUX 결합으로 모바일·데스크톱을 분리 측정한다.
사용 사례
- 에이전시의 대량 클라이언트 감사 자동화용으로 설계되었다. 주간 또는 월간 자동 실행으로 수동 심사에 들어가던 시간을 크게 줄여 동일 인력으로 감사 빈도를 늘릴 수 있다. 각 권고에 실패 판정 기준이 포함되어 고객 검증과 보상 근거로 활용 가능하다.
- 인하우스 SEO 팀의 분기별 리포트 전 사전 점검 도구로 활용된다. 배포 전점검으로 플랫폼 UI가 숨기는 스키마 폐지나 캔온 이슈를 사전에 포착하고 경영진 리뷰 전 핵심 지표를 준비할 수 있다. GA4와 GSC 통합을 통해 대시보드 보완 자료로 사용 가능하다.
- 프리랜서 컨설턴트가 첫 상담에서 빠르게 신뢰를 확보하는 도구로 쓰인다. 15분 안에 사이트 점수와 우선순위 3개를 제시해 발주 결정 단계에서 가치 증명이 가능하다. 마크다운·PDF 출력으로 제안 문서로 바로 활용할 수 있다.
시작하기
플러그인 마켓플레이스 경로로 설치하거나 리포지토리를 복제한 뒤 제공된 install 스크립트를 실행하면 기본 설치가 완료된다. Claude Code를 기동한 뒤 /seo audit <url> 같은 명령으로 전체 사이트 감사를 실행하면 병렬 에이전트가 작업을 수행한다. 추가로 Google API나 MCP 확장을 연결하려면 /seo google setup 명령을 통해 자격증명 마법사를 실행하면 된다.
요구사항
- Python 3.10 이상이 필요하다. Claude Code CLI가 사전 설치되어 있어야 플러그인이 정상 동작하며 선택적으로 Playwright Chromium이 설치되면 SPA 렌더링 기능을 사용할 수 있다. Google API 연동이 필요하면 해당 키와 OAuth 또는 서비스 계정 구성이 요구된다.
벤치마크
| 벤치마크 | 지표 | 값 | 비교 |
|---|---|---|---|
| Time per audit | time | 10-15 min | vs manual audit 4-8 hrs |
| Test suite | passing tests | 326 passing | — |
| Test coverage migration | tests | 271 | was 248 in prior baseline |
이미지 분석



12.1k
Stars
1.8k
Forks
+207
Trending
0
조회수
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.