GEO 우선, SEO 지원. 전통적인 SEO (Search Engine Optimization) 기반을 유지하면서 AI 기반 검색 엔진(ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews)에 맞춰 웹사이트를 최적화합니다.

AI 검색이 전통적인 검색을 잠식하고 있습니다. 이 도구는 트래픽이 과거에 머물렀던 곳이 아니라, 트래픽이 이동하고 있는 곳을 위해 최적화합니다.

git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install.sh

Git Bash가 포함된 Git for Windows가 필요합니다.

# 옵션 1: 한 줄 명령 설치 (PowerShell/CMD가 아닌 Git Bash에서 실행)
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash
# 옵션 2: 수동 설치
...

참고: 폴더를 마우스 오른쪽 버튼으로 클릭하고 "여기서 Git Bash 열기"를 선택하거나, Git Bash를 열고 해당 디렉토리로 이동하세요. PowerShell이나 명령 프롬프트(Command Prompt)를 사용하지 마세요.

• Python 3.8+ (Debian/Ubuntu의 경우 python3-venv 포함)
• Claude Code CLI
• Git
• 선택 사항: uv — 설치되어 있는 경우, 설치 프로그램이 더 빠른 의존성 설치를 위해 이를 사용합니다.
• 선택 사항: Playwright (스크린샷용)

Python 의존성은 ~/.claude/skills/geo/.venv/에 전용 가상 환경 (virtual environment)으로 설치됩니다. 시스템 Python은 건드리지 않으며, 스킬을 삭제하면 venv와 나머지 파일들이 함께 제거됩니다.

스킬 및 에이전트 파일이 해당 venv를 직접 참조하므로, 이 도구는 사용자의 PATH에서 python3가 무엇으로 해결되든 상관없이 작동합니다.

Claude Code를 열고 다음 명령어를 사용하세요:

geo-seo-claude/
├── geo/ # 메인 스킬 오케스트레이터 (Main skill orchestrator)
│ └── SKILL.md # 명령어 및 라우팅이 포함된 기본 스킬 파일
...

CRM 및 보고 스킬 (/geo prospect, /geo proposal, /geo compare)은 Claude Code 디렉토리 외부의 런타임 데이터를 저장합니다:

~/.geo-prospects/
├── prospects.json # 클라이언트/잠재 고객 파이프라인 데이터
├── proposals/ # 생성된 제안서 문서
...

이 디렉토리는 언인스톨러(uninstaller)에 의해 삭제되지 않습니다. 잠재 고객 데이터가 더 이상 필요하지 않다면 수동으로 삭제하십시오.

/geo audit https://example.com을 실행하면 다음과 같이 진행됩니다:

탐색 (Discovery)— 홈페이지를 가져오고, 비즈니스 유형을 감지하며, 사이트맵을 크롤링합니다.
병렬 분석 (Parallel Analysis)— 5개의 서브에이전트 (subagents)를 동시에 실행합니다:

• AI 가시성 (인용 가능성, 크롤러, llms.txt, 브랜드 언급)
• 플랫폼 분석 (ChatGPT, Perplexity, Google AIO 준비도)
• 기술적 SEO (Core Web Vitals, SSR, 보안, 모바일)
• 콘텐츠 품질 (E-E-A-T, 가독성, 최신성)
• 스키마 마크업 (Schema Markup) (감지, 검증, 생성)

종합 (Synthesis)— 점수를 집계하고 종합 GEO 점수 (0-100)를 생성합니다.
보고 (Report)— 즉각적인 성과를 낼 수 있는 우선순위 실행 계획을 출력합니다.

AI 인용 가능성 및 가시성 (AI Citability & Visibility)— 콘텐츠 블록을 분석하여 AI 인용 준비 상태를 확인합니다. 최적의 AI 인용 구절은 134-167 단어이며, 독립적이고, 사실 정보가 풍부하며, 질문에 직접적으로 답변하는 형태입니다.

크롤러 접근성 (Crawler Accessibility)— 14개 이상의 AI 크롤러 (GPTBot, ClaudeBot, PerplexityBot 등)에 대해 robots.txt를 점검하고 구체적인 허용/차단 (allow/block) 권장 사항을 제공합니다.

브랜드 언급 (Brand Mentions)— 브랜드 언급은 백링크 (backlinks)보다 AI 가시성과 3배 더 강력한 상관관계를 가집니다. YouTube, Reddit, Wikipedia, LinkedIn 및 7개 이상의 기타 플랫폼을 스캔합니다.

교차 플랫폼 가시성 (Cross-Platform Visibility)— 동일한 쿼리에 대해 ChatGPT와 Google AI Overviews 모두에서 인용되는 도메인은 단 11%에 불과합니다. 플랫폼별 맞춤형 권장 사항을 제공합니다.

llms.txt 생성— AI 크롤러가 사이트 구조를 이해하도록 돕는 신흥 표준인 llms.txt 파일을 생성합니다.

전문 GEO 보고서 (Professional GEO Reports)— Markdown 또는 PDF 형식의 전문적인 GEO 보고서를 생성합니다. PDF 보고서에는 점수 게이지, 막대 그래프, 플랫폼 준비 상태 시각화, 색상 구분 테이블 및 우선순위가 지정된 실행 계획이 포함되어 있어 클라이언트에게 즉시 전달할 수 있습니다.

GEO 에이전시 (GEO Agencies)— 클라이언트 감사를 수행하고 결과물을 생성합니다.
마케팅 팀 (Marketing Teams)— AI 검색 가시성을 모니터링하고 개선합니다.
콘텐츠 크리에이터 (Content Creators)— AI 인용을 위해 콘텐츠를 최적화합니다.
로컬 비즈니스 (Local Businesses)— AI 어시스턴트가 자신을 찾을 수 있도록 합니다.
SaaS 기업 (SaaS Companies)— AI 플랫폼 전반에서 엔티티 인식 (entity recognition)을 개선합니다.
이커머스 (E-commerce)— AI 쇼핑 추천을 위해 제품 페이지를 최적화합니다.

./uninstall.sh

또는 수동으로:

rm -rf ~/.claude/skills/geo ~/.claude/skills/geo-* ~/.claude/agents/geo-*.md

이 도구는 무료입니다. 이를 수익화하는 방법을 배우는 것이 커뮤니티의 역할입니다.

내부 구성 요소:

비디오 워크스루 (Video walkthroughs)— 단계별 설정, 감사 실행, 결과 해석 방법
클라이언트 확보 플레이북 (Client acquisition playbook)— 잠재 고객을 찾고, GEO 서비스를 제안하고, 계약을 성사시키는 방법
라이브 오피스 아워 (Live office hours)— 감사 결과를 가져오면 직접적인 도움을 받을 수 있습니다.
GEO 에이전시 가격 책정 및 템플릿 (GEO agency pricing & templates)— 제안서 문서, 콜드 아웃리치 (cold outreach) 스크립트, 온보딩 워크플로우

GEO 에이전시는 월 $2,000~$12,000를 청구합니다. 이 도구가 감사를 수행합니다. 커뮤니티는 이를 판매하는 방법을 가르쳐 줍니다.

MIT License

기여(Contributions)를 환영합니다!

AI 검색 시대를 위해 구축되었습니다.