geo-seo-claude README

The project's README from github.com/zubair-trabzada/geo-seo-claude. As one markdown file: README.md.

GEO-SEO Claude Code Skill

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

Star History Chart

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)

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

Manual Install

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.

# 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

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

Architecture

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
│   ├── geo-ai-visibility.md      # GEO audit, citability, crawlers, brands
│   ├── geo-platform-analysis.md  # Platform-specific optimization
│   ├── geo-technical.md          # Technical SEO analysis
│   ├── geo-content.md            # Content & E-E-A-T analysis
│   └── geo-schema.md             # Schema markup analysis
├── scripts/                      # Python utilities
│   ├── fetch_page.py             # Page fetching & parsing
│   ├── citability_scorer.py      # AI citability scoring engine
│   ├── brand_scanner.py          # Brand mention detection
│   ├── llmstxt_generator.py      # llms.txt validation & generation
│   └── generate_pdf_report.py    # PDF report generator (ReportLab)
├── schema/                       # JSON-LD templates
│   ├── organization.json         # Organization schema (with sameAs)
│   ├── local-business.json       # LocalBusiness schema
│   ├── article-author.json       # Article + Person schema (E-E-A-T)
│   ├── software-saas.json        # SoftwareApplication schema
│   ├── product-ecommerce.json    # Product schema with offers
│   └── website-searchaction.json # WebSite + SearchAction schema
├── install.sh                    # One-command installer
├── uninstall.sh                  # Uninstaller
├── requirements.txt              # Python dependencies
└── README.md                     # This file

Data Storage

The CRM and reporting skills (/geo prospect, /geo proposal, /geo compare) store runtime data outside the Claude Code directory:

~/.geo-prospects/
├── prospects.json              # Client/prospect pipeline data
├── proposals/                  # Generated proposal documents
│   └── <domain>-proposal-<date>.md
└── reports/                    # Monthly delta reports
    └── <domain>-monthly-<YYYY-MM>.md

This directory is not removed by the uninstaller — delete it manually if you no longer need your prospect data.


How It Works

Full Audit Flow

When you run /geo audit https://example.com:

  1. Discovery — Fetches homepage, detects business type, crawls sitemap
  2. 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)
  3. Synthesis — Aggregates scores, generates composite GEO Score (0-100)
  4. 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


Uninstall

./uninstall.sh

Or manually:

rm -rf ~/.claude/skills/geo ~/.claude/skills/geo-* ~/.claude/agents/geo-*.md

Want to Turn This Into a Business?

The tool is free. Learning how to monetize it is where the community comes in.

Join the AI Workshop Community →

Inside you'll get:

GEO agencies charge $2K–$12K/month. This tool does the audit. The community teaches you how to sell it.


License

MIT License


Contributing

Contributions welcome!


Built for the AI search era.

geo-seo-claude (zubair-trabzada/geo-seo-claude)

Searching Database…

这是什么?这是一个以 GEO(生成式引擎优化)为重点的 SEO 技能,安装在 Claude Code 中,用于审核和优化网站,适配 ChatGPT、Claude、Perplexity、Gemini、Google AI Overviews 等 AI 搜索引擎,同时兼顾传统 SEO。
这是独立的应用程序,还是接入 Claude Code 的?它是一个安装到 Claude Code 中的技能。你完全通过斜杠命令来使用它,例如在 Claude Code 命令行中输入 /geo audit,而不是打开一个单独的应用程序。
安装前我需要准备什么?你需要 Python 3.8+(在 Debian/Ubuntu 上还需要 python3-venv)、Claude Code 命令行工具和 Git。uv 和 Playwright 是可选的,分别用于加快安装速度和生成截图。
Windows 上安装有什么需要注意的坑吗?在 Windows 上必须通过 Git Bash 安装(随 Git for Windows 一起提供)。安装程序明确不支持 PowerShell 和命令提示符。
这个工具是给谁用的?它面向运行客户审核的 GEO 代理机构、营销团队、内容创作者、本地商家、SaaS 公司,以及希望提升 AI 搜索可见度的电商网站。
/geo audit 命令到底做什么?它会先发现网站,然后并行启动五个子代理,分别负责 AI 可见度、平台就绪度、技术 SEO、内容质量和结构化数据标记,最后综合所有结果,给出一个 0–100 分的 GEO 综合评分,以及按优先级排序的行动计划。
GEO 评分是怎么计算的?这是一个加权综合评分:AI 可引用性与可见度占 25%,品牌权威信号占 20%,内容质量与 E-E-A-T 占 20%,技术基础占 15%,结构化数据占 10%,平台优化占 10%。
我能用它生成一份可以交给客户的报告吗?可以。/geo report-pdf 会生成一份专业 PDF,包含评分仪表、柱状图、平台就绪度图示和按优先级排序的行动计划;/geo report 则生成 Markdown 版本。
这个工具本身免费吗?免费。该技能采用 MIT 许可证,完全免费。作者另外销售一个付费社区(Skool),教人如何把 GEO 审核做成客户服务业务。
Size
0.3 MB
Stars
11.1K
Updated
CommitOct 05
Age
7mo
Commits · 90 Days