geo-seo-claude
CLI Toolzubair-trabzada/geo-seo-claude
Optimize websites for AI search engines with GEO audits, scoring, and reports.
Overview
A Claude Code skill that audits and optimizes websites for generative engine optimization (GEO). It scores AI citability, checks crawler access, analyzes brand authority, validates schema markup, and generates PDF reports for client use.
README Preview
\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)
TroubleshootingHow to fix 'No matching distribution found for Pillow>=12.1.0' when running install.sh on macOS?
The installer is using macOS system Python 3.9.6, but the pinned packages require Python 3.10 or newer. Install a newer Python and make sure python3 resolves to it during installation:
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 # Must show Python 3.10+
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bashThe permanent installer fix is to probe versioned interpreters such as python3.13, python3.12, python3.11, and python3.10, accept only one where sys.version_info >= (3, 10), and update the prerequisite message from Python 3.8+ to Python 3.10+.
TroubleshootingWhy does the schema audit fail to detect JSON-LD markup located in the HTML <head>?
The audit fails because WebFetch strips <head> content during HTML-to-markdown conversion, while JSON-LD schema blocks are often placed in <head>. The fix is to use fetch_page.py for page retrieval and schema detection instead of WebFetch, because it correctly extracts JSON-LD. Update the geo-schema agent and skill to call fetch_page.py, then rerun the audit.
TroubleshootingHow to fix "Agent type 'geo-citability' not found" when running /geo-audit?
The /geo-audit command references two agent types that are not registered in the installation: geo-citability and geo-brand-mentions. This is a command/agent-registration mismatch, not a problem with the webpage or your input. As a workaround, use one of the available geo agents instead: geo-ai-visibility, geo-content, geo-platform-analysis, geo-schema, or geo-technical. Update to the latest version or restart the agent environment; if the latest build still does not list the missing agents, the repository must register or add them.