GEO-First SEO with Claude Code: Optimize for AI Search Engines
Learn how to use the geo-seo-claude skill for Claude Code to audit and optimize websites for AI-powered search engines like ChatGPT, Claude, and Perplexity.
GEO-First SEO with Claude Code: Optimize for AI Search Engines
Traditional SEO is no longer enough. AI-powered search engines like ChatGPT, Claude, Perplexity, and Google AI Overviews are reshaping how users discover content. The geo-seo-claude skill for Claude Code gives you a comprehensive toolkit to audit, score, and optimize any website for this new paradigm.
Why GEO Matters in 2026
The shift is real and accelerating. The GEO services market is already valued at $850M+ and projected to hit $7.3B by 2031. AI-referred traffic has grown +527% year-over-year, and AI traffic converts at 4.4x the rate of organic search. Gartner predicts a -50% drop in traditional search traffic by 2028.
Perhaps the most telling stat: brand mentions correlate 3x more strongly with AI visibility than backlinks. Yet only 23% of marketers are actively investing in GEO.
What is geo-seo-claude?
This open-source skill transforms Claude Code into a GEO-first SEO analysis engine. It runs a full audit using 13 specialized sub-skills and 5 parallel subagents, covering everything from citability scoring to PDF report generation.
Quick Start
Install on macOS/Linux with one command:
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash
For Windows (Git Bash required):
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash
Requirements: Python 3.8+, Claude Code CLI, Git. Optional: uv for faster dependency install, Playwright for screenshots.
The installer creates an isolated Python virtual environment at ~/.claude/skills/geo/.venv/ โ your system Python stays untouched.
Core Commands
Once installed, open Claude Code and use these commands:
| Command | What It Does |
|---|---|
/geo audit <url> |
Full GEO + SEO audit with parallel subagents |
/geo quick <url> |
60-second GEO visibility snapshot |
/geo citability <url> |
Score content for AI citation readiness |
/geo crawlers <url> |
Check AI crawler access (robots.txt) |
/geo llmstxt <url> |
Analyze or generate llms.txt |
/geo brands <url> |
Scan brand mentions across AI-cited platforms |
/geo platforms <url> |
Platform-specific optimization |
/geo schema <url> |
Structured data analysis & generation |
/geo technical <url> |
Technical SEO audit |
/geo content <url> |
Content quality & E-E-A-T assessment |
/geo report <url> |
Generate client-ready GEO report |
/geo report-pdf |
Generate professional PDF report with charts |
How a Full Audit Works
When you run /geo audit https://example.com, the system executes a multi-stage pipeline:
- Discovery โ Fetches the homepage, detects business type, crawls the sitemap
- Parallel Analysis โ Launches 5 subagents simultaneously:
- AI Visibility (citability, crawlers, llms.txt, brand mentions)
- Platform Analysis (ChatGPT, Perplexity, Google AIO readiness)
- Technical SEO (Core Web Vitals, SSR, security, mobile)
- Content Quality (E-E-A-T, readability, freshness)
- Schema Markup (detection, validation, generation)
- Synthesis โ Aggregates scores into a composite GEO Score (0-100)
- Report โ Outputs a prioritized action plan with quick wins
Scoring Methodology
The composite score is weighted across five categories:
| Category | Weight |
|---|---|
| AI Citability & Visibility | 25% |
| Brand Authority Signals | 20% |
| Content Quality & E-E-A-T | 20% |
| Technical Foundations | 15% |
| Structured Data | 10% |
| Platform Optimization | 10% |
Key Features in Depth
Citability Scoring
AI models cite content in specific ways. Optimal passages are 134-167 words, self-contained, fact-rich, and directly answer questions. The citability scorer analyzes content blocks and scores them for AI citation readiness.
AI Crawler Analysis
Checks robots.txt for 14+ AI crawlers including GPTBot, ClaudeBot, and PerplexityBot. Provides specific allow/block recommendations so you can control which AI crawlers access your content.
Brand Mention Scanning
Brand mentions correlate 3x more strongly with AI visibility than backlinks. The brand scanner checks YouTube, Reddit, Wikipedia, LinkedIn, and 7+ other platforms for mentions of your brand.
Platform-Specific Optimization
Only 11% of domains are cited by both ChatGPT and Google AI Overviews for the same query. The platform optimizer provides tailored recommendations per platform, recognizing that each AI search engine has different citation patterns.
llms.txt Generation
The emerging llms.txt standard helps AI crawlers understand your site structure. This skill can analyze existing files or generate one from scratch.
Client-Ready Reports
Generates professional GEO reports in Markdown or PDF format. PDF reports include score gauges, bar charts, platform readiness visualizations, color-coded tables, and prioritized action plans โ ready to deliver to clients.
Architecture Overview
The repository is organized into clear modules:
geo-seo-claude/
โโโ geo/ # Main skill orchestrator
โ โโโ SKILL.md # Primary skill file with commands & routing
โโโ skills/ # 13 specialized sub-skills
โ โโโ geo-audit/ # Full audit orchestration & scoring
โ โโโ geo-citability/ # AI citation readiness scoring
โ โโโ geo-crawlers/ # AI crawler access analysis
โ โโโ geo-llmstxt/ # llms.txt standard analysis & generation
โ โโโ geo-brand-mentions/ # Brand presence on AI-cited platforms
โ โโโ geo-platform-optimizer/ # Platform-specific AI search optimization
โ โโโ geo-schema/ # Structured data for AI discoverability
โ โโโ geo-technical/ # Technical SEO foundations
โ โโโ geo-content/ # Content quality & E-E-A-T
โ โโโ geo-report/ # Client-ready markdown report generation
โ โโโ geo-report-pdf/ # Professional PDF report with charts
โ โโโ geo-prospect/ # CRM-lite prospect pipeline management
โ โโโ geo-proposal/ # Auto-generate client proposals
โ โโโ geo-compare/ # Monthly delta tracking & progress reports
โโโ agents/ # 5 parallel subagents
โโโ scripts/ # Python utilities
โโโ schema/ # JSON-LD templates
โโโ install.sh # One-command installer
Use Cases
- GEO Agencies โ Run client audits and generate deliverables
- Marketing Teams โ Monitor and improve AI search visibility
- Content Creators โ Optimize content for AI citations
- Local Businesses โ Get found by AI assistants
- SaaS Companies โ Improve entity recognition across AI platforms
- E-commerce โ Optimize product pages for AI shopping recommendations
Turning This Into a Business
The tool is free and open-source (MIT license). The community around it teaches you how to monetize it. GEO agencies charge $2Kโ$12K/month for these services.
Uninstall
./uninstall.sh
Or manually:
rm -rf ~/.claude/skills/geo ~/.claude/skills/geo-* ~/.claude/agents/geo-*.md
Prospect data stored in ~/.geo-prospects/ is not removed by the uninstaller โ delete it manually if needed.
Final Thoughts
AI search is eating traditional search. The geo-seo-claude skill gives you a production-ready toolkit to optimize for where traffic is going, not where it was. Whether you're an agency owner, marketer, or developer, this is the most comprehensive open-source GEO tool available today.