README

GEO-first, SEO-supported. Optimize websites for AI-powered search engines
  (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations.



  AI search is eating traditional search. This tool optimizes for where traffic is going, not where it was.


---

 Star History


 
   
   
   
 


---

 Why GEO Matters (2026)

| Metric | Value |
|--------|-------|
| GEO services market | $850M+ (projected $7.3B by 2031) |
| AI-referred traffic growth | +527% year-over-year |
| AI traffic conversion rate vs organic | 4.4x higher |
| Gartner: search traffic drop by 2028 | -50% |
| Brand mentions vs backlinks for AI | 3x stronger correlation |
| Marketers investing in GEO | Only 23% |

---

 Quick Start

 One-Command Install (macOS/Linux)

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


 Manual Install

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


 Windows (Git Bash)

Requires Git for Windows which includes Git Bash.

bash
 Option 1: One-command install (run from Git Bash, not PowerShell/CMD)
curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash

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


 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.

 Requirements

- Python 3.10+ (on Debian/Ubuntu also python3-venv)
- Claude Code CLI
- Git
- Optional: uv — if present, the installer uses it for a faster dependency install
- Optional: Playwright (for screenshots)

 Isolated install

Python dependencies are installed into a dedicated virtual environment at
~/.claude/skills/geo/.venv/. Your system Python is not touched, and
uninstalling the skill removes the venv together with the rest of the files.

Skill and agent files reference that venv directly, so the tool works
regardless of what python3 resolves to on your PATH.

---

 Commands

Open Claude Code and use these commands:

| Command | What It Does |
|---------|-------------|
| /geo audit  | Full GEO + SEO audit with parallel subagents |
| /geo quick  | 60-second GEO visibility snapshot |
| /geo citability  | Score content for AI citation readiness |
| /geo crawlers  | Check AI crawler access (robots.txt) |
| /geo llmstxt  | Analyze or generate llms.txt |
| /geo brands  | Scan brand mentions across AI-cited platforms |
| /geo platforms  | Platform-specific optimization |
| /geo schema  | Structured data analysis & generation |
| /geo technical  | Technical SEO audit |
| /geo content  | Content quality & E-E-A-T assessment |
| /geo report  | Generate client-ready GEO report |
| /geo report-pdf | Generate professional PDF report with charts & visualizations |

---

 Architecture


geo-seo-claude/
├── geo/                           Mai