geo-seo-claude
무엇인가
geo-seo-claude는 생성형 AI 검색(ChatGPT·Claude·Perplexity·Gemini·Google AI Overviews)에서 웹사이트가 인용되도록 만드는 감사 절차를 Claude Code에 주입하는 스킬 묶음이다. 전통 SEO 기반을 유지한 채 인용 가능성, AI 크롤러 접근성, 브랜드 언급, 구조화 데이터, 플랫폼별 대응을 하나의 점수 체계로 규율한다.
어떻게 동작하나
구조는 최상위 오케스트레이터 `geo/SKILL.md`와 13개 하위 스킬(`geo-audit`, `geo-citability`, `geo-crawlers`, `geo-llmstxt`, `geo-brand-mentions`, `geo-platform-optimizer`, `geo-schema`, `geo-technical`, `geo-content`, `geo-report`, `geo-report-pdf`, `geo-prospect`, `geo-proposal`, `geo-compare`)로 나뉜다. `/geo audit https://example.com` 같은 슬래시 명령으로 발동하며, 홈페이지를 가져와 사업 유형을 판별하고 사이트맵을 크롤한 뒤 5개 서브에이전트(AI 가시성·플랫폼 분석·기술 SEO·콘텐츠·스키마)를 병렬 실행한다. 점수 산출과 페이지 파싱, 브랜드 언급 탐지, llms.txt 생성, PDF 리포트 생성은 `scripts/` 아래 Python 유틸리티가 담당하고, `schema/` 에는 Organization·LocalBusiness·Article+Person·SoftwareApplication·Product·WebSite+SearchAction JSON-LD 템플릿이 들어 있다.
무엇과 다른가
프롬프트를 매번 직접 쓰거나 CLAUDE.md에 문장 몇 줄을 넣는 방식과 달리, 점검 항목이 실행 가능한 스크립트와 템플릿 파일로 고정되어 있다. 인용 준비도 점수와 크롤러 접근 판정이 사람의 판단이 아니라 스크립트 출력으로 나오고, 감사가 5개 서브에이전트 병렬 실행으로 분해되며, 영업 파이프라인 데이터(`~/.geo-prospects/`)를 저장소 밖에 누적해 월간 변화 추적(`/geo compare`)과 제안서 생성(`/geo proposal`)까지 이어진다.
어떻게 쓰나
설치는 `curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash` 한 줄이거나 저장소를 클론한 뒤 `./install.sh` 를 실행한다. Windows는 Git Bash에서 `install-win.sh` 를 쓴다(PowerShell·CMD 사용 불가). Python 의존성은 `~/.claude/skills/geo/.venv/` 전용 가상환경에 들어가 시스템 Python을 건드리지 않으며, 스킬·에이전트 파일이 그 경로를 직접 참조한다. 설치 후 Claude Code에서 `/geo audit` 로 첫 감사를 돌린다.
전제와 한계
Claude Code CLI, Python 3.8+(Debian/Ubuntu는 `python3-venv`), Git이 필요하고 `uv` 와 Playwright(스크린샷)는 선택 사항이다. 지원 대상은 Claude Code이며 Codex·Cursor·Copilot용 규칙 파일은 제공하지 않는다. 점수는 스크립트의 휴리스틱 산출물이라 검색엔진 순위를 보장하지 않고, 제거 스크립트는 `~/.geo-prospects/` 의 영업·리포트 데이터를 지우지 않으므로 직접 삭제해야 한다.