geo-seo-claude
CLI 도구zubair-trabzada/geo-seo-claude
AI 검색 엔진을 위한 웹사이트 최적화, GEO 감사, 점수 및 보고서를 제공합니다.
개요
웹사이트에 대한 생성 엔진 최적화(GEO) 감사 및 최적화를 수행하는 Claude Code 스킬입니다. AI 인용 가능성을 평가하고, 크롤러 접근을 확인하고, 브랜드 권위를 분석하고, 구조화된 데이터를 검증하며, 고객용 PDF 보고서를 생성합니다.
README 미리보기
\n \n\n\n\n GEO-first, SEO-supported. Optimize websites for AI-powered search engines\n (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations.\n\n\n\n AI search is eating traditional search. This tool optimizes for where traffic is going, not where it was.\n\n\n---\n\n## Star History\n\n\n \n \n \n \n\n\n---\n\n## Why GEO Matters (2026)\n\n| Metric | Value |\n|--------|-------|\n| GEO services market | $850M+ (projected $7.3B by 2031) |\n| AI-referred traffic growth | +527% year-over-year |\n| AI traffic conversion rate vs organic | 4.4x higher |\n| Gartner: search traffic drop by 2028 | -50% |\n| Brand mentions vs backlinks for AI | 3x stronger correlation |\n| Marketers investing in GEO | Only 23% |\n\n---\n\n## Quick Start\n\n### One-Command Install (macOS/Linux)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash\n```\n\n### Manual Install\n\n```bash\ngit clone https://github.com/zubair-trabzada/geo-seo-claude.git\ncd geo-seo-claude\n./install.sh\n```\n\n### Windows (Git Bash)\n\nRequires [Git for Windows](https://git-scm.com/downloads) which includes Git Bash.\n\n```bash\n# Option 1: One-command install (run from Git Bash, not PowerShell/CMD)\ncurl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash\n\n# Option 2: Manual install\ngit clone https://github.com/zubair-trabzada/geo-seo-claude.git\ncd geo-seo-claude\n./install-win.sh\n```\n\n> **Note:** Right-click the folder and select "Open Git Bash here", or open Git Bash and navigate to the directory. Do not use PowerShell or Command Prompt.\n\n### Requirements\n\n- Python 3.8+ (on Debian/Ubuntu also `python3-venv`)\n- Claude Code CLI\n- Git\n- Optional: [`uv`](https://docs.astral.sh/uv/) — if present, the installer uses it for a faster dependency install\n- Optional: Playwright (for screenshots)\n\n### Isolated install\n\nPython dependencies are
FAQ (3)
문제 해결macOS에서 install.sh를 실행할 때 'No matching distribution found for Pillow>=12.1.0' 오류를 해결하는 방법
설치 프로그램이 macOS 시스템 Python 3.9.6을 사용하고 있지만, 버전이 고정된 패키지에는 Python 3.10 이상이 필요합니다. 최신 버전의 Python을 설치하고, 설치 중에 python3이 해당 버전을 가리키도록 하세요:
brew install python@3.12
rm -rf ~/.claude/skills/geo
mkdir -p /tmp/pybin
ln -sf "$(brew --prefix python@3.12)/bin/python3.12" /tmp/pybin/python3
export PATH="/tmp/pybin:$PATH"
python3 --version # Python 3.10 이상이 표시되어야 합니다
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash설치 프로그램의 영구적인 수정 방안은 python3.13, python3.12, python3.11, python3.10과 같이 버전이 명시된 인터프리터를 탐색하여 sys.version_info >= (3, 10)을 만족하는 인터프리터만 허용하고, 사전 요구 사항 메시지를 Python 3.8+에서 Python 3.10+로 업데이트하는 것입니다.
문제 해결스키마 감사가 HTML <head>에 위치한 JSON-LD 마크업을 감지하지 못하는 이유는 무엇인가요?
감사가 실패하는 이유는 WebFetch가 HTML-to-markdown 변환 과정에서 <head> 콘텐츠를 제거하는 반면, JSON-LD 스키마 블록은 종종 <head>에 배치되기 때문입니다. 해결 방법은 WebFetch 대신 fetch_page.py를 사용하여 페이지 검색 및 스키마 감지를 수행하는 것이며, 이 도구는 JSON-LD를 올바르게 추출하기 때문입니다. geo-schema 에이전트와 스킬이 fetch_page.py를 호출하도록 업데이트한 다음 감사를 다시 실행하세요.
문제 해결/geo-audit 실행 시 "Agent type 'geo-citability' not found" 오류를 해결하는 방법
/geo-audit 명령은 설치에 등록되지 않은 두 가지 에이전트 유형(geo-citability 및 geo-brand-mentions)을 참조합니다. 이는 웹페이지나 입력의 문제가 아니라 명령/에이전트 등록 불일치 문제입니다. 해결 방법으로 사용 가능한 geo 에이전트 중 하나를 대신 사용하세요: geo-ai-visibility, geo-content, geo-platform-analysis, geo-schema 또는 geo-technical. 최신 버전으로 업데이트하거나 에이전트 환경을 다시 시작하세요. 최신 빌드에도 누락된 에이전트가 여전히 나열되지 않으면 리포지토리에서 해당 에이전트를 등록하거나 추가해야 합니다.