claude-seo
무엇인가
claude-seo는 Claude Code에 SEO 감사 절차를 주입하는 플러그인형 스킬 묶음이다. 규율 대상은 기술 SEO, 콘텐츠 품질(E-E-A-T), Schema.org 마크업, AI 검색 최적화(GEO/AEO), 백링크, 로컬 SEO, 지도 인텔리전스, 시맨틱 클러스터링, 이커머스 SEO, 국제 SEO, Google API 연동, PDF/Excel 리포트다. 산출물은 Google 1차 출처 지침에 근거한 검증 가능한 권고와 우선순위 조치 계획이다.
어떻게 동작하나
구조는 오케스트레이터 하나와 하위 스킬, 전문 서브에이전트로 나뉜다. 사용자는 `/seo` 슬래시 명령으로 발동하며, 오케스트레이터·하위 스킬·MCP 확장을 합쳐 32개 명령이 노출된다. 사이트 전체 감사에서는 최대 15개 전문 에이전트가 동시에 팬아웃되고, 각 권고에는 그것이 딛고 선 제1원리 관찰, 의존 관계, "이것이 실패했음을 어떻게 알 것인가" 검증 항목, 선행 지표가 함께 붙는다.
무엇과 다른가
프롬프트를 직접 쓰거나 단일 CLAUDE.md 규칙 파일을 두는 방식과 다르다. 규칙이 문서 한 장이 아니라 실행 단위로 쪼개져 있고, 플러그인 마켓플레이스를 통해 배포·설치된다. 감사 로직은 오케스트레이터가 하위 스킬과 전문 에이전트를 병렬 호출하는 형태로 돌아가며, 선택적 확장(DataForSEO, Firecrawl, Banana)이 MCP 계층으로 붙는다.
어떻게 쓰나
설치는 플러그인 경로가 가장 짧다. `/plugin marketplace add AgriciDaniel/claude-seo` 후 `/plugin install claude-seo@agricidaniel-claude-seo`, 이어서 `/seo setup`을 실행한다. setup은 Claude의 영속 플러그인 데이터 안에 격리된 Python 환경을 만들고 Playwright Chromium을 설치하며, 상태는 `/seo doctor`로 확인한다. 첫 사용은 `/seo audit https://example.com` 같은 감사 명령이다. 수동 설치는 저장소를 `git clone --depth 1`한 뒤 `install.sh`(Unix/macOS/Linux) 또는 `install.ps1`(Windows PowerShell)을 실행한다.
전제와 한계
전제는 Claude Code 1.0.33 이상이다. setup이 만드는 Python 환경과 Playwright Chromium 외에 전역 Python 패키지나 PATH 심을 요구하지 않는다. DataForSEO·Firecrawl·Banana 확장은 선택 사항이다. Codex를 쓴다면 TOML 에이전트와 결정론적 러너로 포팅된 별도 Codex SEO를 사용해야 하며, 이 저장소는 Claude Code 대상이다.