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.
# 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.8+ (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 <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 & visualizations
Report — Outputs prioritized action plan with quick wins
Scoring Methodology
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
Citability Scoring
Analyzes content blocks for AI citation readiness. Optimal AI-cited passages are 134-167 words, self-contained, fact-rich, and directly answer questions.
AI Crawler Analysis
Checks robots.txt for 14+ AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) and provides specific allow/block recommendations.
Brand Mention Scanning
Brand mentions correlate 3x more strongly with AI visibility than backlinks. Scans YouTube, Reddit, Wikipedia, LinkedIn, and 7+ other platforms.
Platform-Specific Optimization
Only 11% of domains are cited by both ChatGPT and Google AI Overviews for the same query. Provides tailored recommendations per platform.
llms.txt Generation
Generates the emerging llms.txt standard file that helps AI crawlers understand your site structure.
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.
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
What is this?A GEO-first SEO skill for Claude Code that audits and optimizes websites for AI-powered search engines like ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews, alongside traditional SEO.
Is this a standalone app or does it plug into Claude Code?It is a skill that installs into Claude Code; you run it entirely via slash commands like /geo audit inside the Claude Code CLI rather than as a separate application.
What do I need before installing?You need Python 3.8+ (with python3-venv on Debian/Ubuntu), the Claude Code CLI, and Git; uv and Playwright are optional for faster installs and screenshots respectively.
Any install pitfalls on Windows?On Windows you must install through Git Bash (included with Git for Windows); PowerShell and Command Prompt are explicitly not supported for the installer.
Who is this built for?It targets GEO agencies running client audits, marketing teams, content creators, local businesses, SaaS companies, and e-commerce sites wanting AI search visibility.
What does the /geo audit command actually do?It discovers the site, launches five parallel subagents covering AI visibility, platform readiness, technical SEO, content quality, and schema markup, then synthesizes everything into a composite GEO Score from 0-100 with a prioritized action plan.
How is the GEO Score calculated?It's a weighted blend: AI Citability & Visibility 25%, Brand Authority Signals 20%, Content Quality & E-E-A-T 20%, Technical Foundations 15%, Structured Data 10%, and Platform Optimization 10%.
Can it produce a report I can hand to a client?Yes, /geo report-pdf generates a professional PDF with score gauges, bar charts, platform readiness visuals, and a prioritized action plan; /geo report gives a markdown version.
Is the tool itself free?Yes, the skill is MIT-licensed and free; the author separately sells a paid community (Skool) that teaches how to turn GEO audits into a client service business.
A GEO-first SEO skill for Claude Code that audits and optimizes websites for AI-powered search engines like ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews, alongside traditional SEO.