zubair-trabzada/geo-seo-claude

GEO-first SEO skill for Claude Code. Comprehensive AI search optimization for any website — citability scoring, AI crawler analysis, brand authority, schema markup, platform-specific optimization, and PDF reports. If you want learn how to sell this to real businesses, check out the skool community

geo‑seo‑claude – Claude Code용 AI‑search (GEO) 감사 스킬

무엇인가요 – Claude Code의 스킬으로, 웹사이트를 다단계 감사하고 "GEO"(AI 검색) 점수를 생성합니다. ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews와 같은 새로운 AI 기반 검색 엔진이 사이트를 얼마나 잘 발견하고 인용할 수 있는지 확인한 후, 클라이언트용 마크다운 또는 PDF 보고서를 출력합니다.

왜 중요한가요 – 2026년까지 AI 기반 트래픽은 연간 500% 이상 성장하며, 전환율은 기존 유기적 트래픽보다 몇 배 높습니다. 기존 SEO는 가시성을 보장하지 않습니다. 사이트는 AI 크롤러에 대해 인용 가능해야 합니다. 이 도구는 이를 자동화합니다.

주요 기능

기능	설명
완전한 GEO 감사 (`/geo audit <url>`)	5개의 병렬 하위 에이전트(가시성, 플랫폼, 기술, 콘텐츠, 스키마)를 실행하고 0~100의 GEO 점수를 집계합니다.
빠른 스냅샷 (`/geo quick`)	60초 내 가시성 개요.
인용 가능성 점수 (`/geo citability`)	AI 인용 준비 상태를 콘텐츠 블록 단위로 평가(이상적인 길이: 134~167단어, 자가 완결, 사실 중심).
AI 크롤러 확인 (`/geo crawlers`)	`robots.txt`를 분석해 14개 이상의 AI 봇(GPTBot, ClaudeBot 등)을 식별하고 allow/block 규칙 제안.
브랜드 언급 스캔 (`/geo brands`)	YouTube, Reddit, Wikipedia, LinkedIn 등에서 브랜드 언급을 검색하고 권위 신호를 보고.
llms.txt 처리 (`/geo llmstxt`)	AI 크롤러에게 사이트 구조를 알리는 새로운 `llms.txt` 파일을 검증하거나 생성.
스키마 분석/생성 (`/geo schema`)	누락된 JSON‑LD를 탐지하고 템플릿과 일치 여부를 검증하며, 바로 붙여넣을 수 있는 마크업을 생성 가능.
보고서 생성 (`/geo report`, `...‑pdf`)	점수 게이지, 막대 그래프, 우선순위별 작업 항목을 포함한 마크다운 또는 PDF 클라이언트 보고서 생성.
잠재 고객/제안 도우미 (`/geo prospect`, `/geo proposal`)	가벼운 CRM로, 파이프라인 데이터를 저장하고 자동으로 제안서 문서 생성 가능.

아키텍처 개요

geo-seo-claude/
├─ geo/                # 진입점 (SKILL.md) – /geo 명령 정의
├─ skills/            # 13개의 집중형 하위 스킬 (audit, citability, crawlers…)
├─ agents/            # 5개의 병렬 에이전트 마크다운 파일 (작업 조율)
├─ scripts/           # Python 유틸리티 (페이지 가져오기, 점수 계산, PDF 생성)
├─ schema/            # 스키마 하위 스킬에서 사용하는 JSON‑LD 템플릿
└─ install.sh / uninstall.sh

모든 Python 코드는 ~/.claude/skills/geo/.venv/ 내 격리된 가상 환경에서 실행되며, 시스템 Python은 그대로 유지됩니다.

설치 및 요구 사항

원라인 (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash

수동 설치 – 리포지토리 복제 후 ./install.sh 실행 (Windows에서는 Git Bash에서 install‑win.sh 사용).
의존성 – Python 3.8+, Claude Code CLI, Git; uv는 pip 설치 속도 향상을 위해, Playwright는 스크린샷 지원을 위해 선택 사항.

일반 워크플로우

Claude Code를 열고 명령어 입력 (예: /geo audit https://example.com).
스킬이 홈페이지를 가져오고 사이트맵을 탐지한 후, 5개의 하위 에이전트를 병렬로 실행.
각 에이전트가 수치적 하위 점수를 반환. 오케스트레이터는 가중치 표(인용 가능성 25%, 브랜드 20%, 콘텐츠 20%, 기술 15%, 스키마 10%, 플랫폼 10%)를 사용해 통합 점수를 계산.
종합 GEO 점수와 마크다운 보고서가 출력됩니다. 클라이언트에게 전송하려면 /geo report-pdf 사용.

데이터 지속성

잠재 고객 및 제안 데이터는 ~/.geo-prospects/에 저장됩니다 (JSON 및 마크다운 파일). 제거 스크립트는 스킬을 삭제하지만 이 디렉터리는 삭제하지 않습니다. 저장된 클라이언트 데이터를 삭제하려면 수동으로 삭제해야 합니다.

라이선스 및 커뮤니티

라이선스: MIT – 무료로 사용, 수정, 상용 가능.
커뮤니티: 저자는 "AI Workshop" 커뮤니티(Skool)를 안내하며, 동영상 가이드, 클라이언트 확보 전략, 에이전시가 이 감사 서비스를 수익화할 수 있도록 지원하는 라이브 오피스 아워를 제공.

TL;DR

geo-seo-claude는 AI 검색 가시성(GEO)을 감사할 수 있는 즉시 실행형 Claude Code 스킬입니다. Python 유틸리티, JSON‑LD 템플릿, 병렬 하위 에이전트 세트를 통합해 수치적 GEO 점수와 전문적인 클라이언트 보고서를 생성하며, SEO 에이전시 및 마케터가 AI 기반 검색 결과로의 전환에 대응할 수 있도록 도와줍니다.