GEO-first SEO: AI SEO optimization for Claude Code
/geo-seo-claudeGEO-first SEO skill for Claude Code targets a real pain point: standard SEO tools ignore AI citations entirely. With AI-referred traffic growing rapidly and traditional search losing ground, knowing your AI citability score matters. The tool bundles citability analysis, crawler checks, brand scanning, E-E-A-T assessment, and PDF reports into one Claude Code command. Worth it for agencies selling GEO services; overkill for a solo blogger who just wants to rank on Google.
Introducing the GEO-first SEO skill for Claude Code
GEO-first SEO skill for Claude Code is a command-line skill that audits a website's readiness for AI search engines. It analyzes citability, checks crawler access, evaluates brand mentions, scores E-E-A-T signals, and generates PDF reports. Thirteen sub-skills and five parallel subagents work together to produce a composite GEO Score from 0 to 100.
Key capabilities for AI search optimization
- ✓Citability scoring analyzes content blocks for AI citation readiness, targeting optimal passage lengths of 134-167 words
- ✓AI crawler analysis checks robots.txt against 14+ crawlers including GPTBot, ClaudeBot, and PerplexityBot
- ✓Brand mention scanning across YouTube, Reddit, Wikipedia, LinkedIn, and 7+ other AI-cited platforms
- ✓Platform-specific optimization for ChatGPT, Perplexity, Google AI Overviews, and Gemini
- ✓llms.txt generation following the emerging standard for AI crawler site understanding
- ✓E-E-A-T and content quality assessment with actionable improvement recommendations
- ✓PDF report generation with score gauges, bar charts, and prioritized action plans
Who can benefit from GEO-first SEO?
- •GEO SEO agencies running client audits and generating deliverables at scale
- •In-house marketing teams tracking AI search visibility improvements over time
- •Content creators optimizing articles for higher citation rates in AI responses
- •Local businesses improving discoverability through AI assistants
- •SaaS companies strengthening entity recognition across AI platforms
- •E-commerce stores optimizing product pages for AI shopping recommendations
Quick start: Installing GEO-first SEO
Python 3.8+, Claude Code CLI, and Git are required. On macOS or Linux, run: curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash. Windows users need Git for Windows with Git Bash and run the install-win.sh script instead. Dependencies install into an isolated virtual environment at ~/.claude/skills/geo/.venv/, leaving your system Python untouched.
Using GEO-first SEO commands in Claude Code
Open Claude Code and run /geo audit <url> for a full GEO plus SEO audit with parallel subagents. Other commands include /geo quick <url> for a 60-second snapshot, /geo citability <url> for citation readiness scoring, /geo crawlers <url> to check AI crawler access, /geo brands <url> for brand mention scanning, /geo llmstxt <url> to analyze or generate llms.txt, /geo schema <url> for structured data analysis, and /geo report-pdf to generate a professional PDF report.
Strengths
- ✓It's designed to optimize websites for emerging AI-powered search engines like Claude, ChatGPT, and Google AI Overviews, anticipating future traffic shifts rather than focusing solely on traditional search.
- ✓The tool offers specialized AI-centric metrics and analyses, including AI citability scoring, checks for over a dozen specific AI crawlers, and brand mention scanning, which the README states correlates strongly with AI visibility.
- ✓It provides comprehensive audit capabilities through multiple parallel subagents, covering technical SEO, content quality (E-E-A-T), structured data, and platform-specific optimization, all synthesized into a composite GEO Score.
- ✓It generates professional, client-ready reports in markdown or PDF format, complete with visual aids like charts, platform readiness visualizations, and prioritized action plans, making it suitable for agencies or consultants.
- ✓The installation process is isolated, using a dedicated Python virtual environment to prevent conflicts with existing system Python setups and allowing for a straightforward uninstallation.
Important considerations for GEO-first SEO
- △Claude Code CLI is a hard dependency—you cannot run this as a standalone script or API
- △Effectively read-only for non-technical users; interpreting GEO scores and action plans requires SEO knowledge
- △The prospect/proposal CRM features store data at ~/.geo-prospects/ which the uninstaller does not remove
- △Newer GEO concepts (llms.txt, citability scoring) lack established industry benchmarks for validation
Exploring other AI SEO and traditional SEO tools
Frequently asked questions about GEO-first SEO
Python 3.8 or higher, the Claude Code CLI, and Git are required. On Debian/Ubuntu, also install python3-venv. Windows users need Git for Windows with Git Bash—do not use PowerShell or Command Prompt. Optional dependencies include uv for faster installs and Playwright for screenshots.
Run this single command on macOS or Linux: curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash. Windows requires Git Bash: curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash. The installer creates an isolated Python virtual environment at ~/.claude/skills/geo/.venv/.
Yes. GEO-first SEO skill for Claude Code is licensed under the MIT license, which permits commercial use, modification, and redistribution. The README even encourages using it to run client audits and suggests joining the community to learn how to monetize GEO SEO services.
Run ./uninstall.sh in the cloned directory, or manually delete these directories: ~/.claude/skills/geo, ~/.claude/skills/geo-*, and ~/.claude/agents/geo-*. Note that data stored in ~/.geo-prospects/ the uninstaller does not remove it; manual intervention is needed for deletion if needed.
GEO-first SEO skill for Claude Code generates client-ready markdown reports and professional PDF reports. PDF reports include score gauges, bar charts, platform readiness visualizations, color-coded tables, and prioritized action plans. Use /geo report <url> for markdown or /geo report-pdf after an audit for the full visual version.
The audit itself processes URLs without persisting data. However, the CRM and proposal features (run via /geo prospect and /geo proposal) store client pipeline data at ~/.geo-prospects/prospects.json and generated proposals at ~/.geo-prospects/proposals/. This directory is outside the Claude Code install path and is not removed by the uninstaller.
Who should try it — and who should skip
Agencies and consultants selling GEO SEO services will find the most value—they can run automated audits and deliver PDF reports to clients. In-house marketers managing brand visibility as AI search grows will benefit from tracking citability scores over time. Skip it if you have no use for Claude Code CLI or only care about traditional Google rankings; the learning curve and sub-agent complexity aren't worth it for casual users.
Still deciding about geo-seo-claude?
One click hands the question to an AI along with this page — see what it says about geo-seo-claude.