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…

11.1K ·GitHub
Geo-seo-claude
Что это такое?GEO-ориентированный SEO-навык для Claude Code, который проверяет и оптимизирует сайты для ИИ-поисковых систем вроде ChatGPT, Claude, Perplexity, Gemini и Google AI Overviews, а также для традиционного SEO.
Это отдельное приложение или оно подключается к Claude Code?Это навык, который устанавливается в Claude Code. Вы запускаете его полностью через слеш-команды, например /geo audit, внутри CLI Claude Code, а не как отдельное приложение.
Что нужно установить до начала работы?Нужны Python 3.8+ (с python3-venv на Debian/Ubuntu), CLI Claude Code и Git. Утилита uv необязательна и ускоряет установку, а Playwright необязателен и нужен для скриншотов.
Есть ли подводные камни при установке на Windows?На Windows установка возможна только через Git Bash, который входит в состав Git for Windows. Установщик прямо не поддерживает PowerShell и Командную строку.
Для кого это создано?Инструмент рассчитан на агентства GEO-оптимизации, которые проводят аудиты для клиентов, на маркетинговые команды, создателей контента, местный бизнес, компании SaaS и интернет-магазины, которым нужна видимость в ИИ-поиске.
Что на самом деле делает команда /geo audit?Она находит сайт и запускает пять параллельных субагентов, которые проверяют видимость в ИИ, готовность платформ, техническое SEO, качество контента и разметку schema. Затем всё сводится в общую GEO Score от 0 до 100 с приоритизированным планом действий.
Как считается GEO Score?Это взвешенная сумма: цитируемость и видимость в ИИ — 25%, сигналы авторитета бренда — 20%, качество контента и E-E-A-T — 20%, техническая основа — 15%, структурированные данные — 10%, оптимизация под платформы — 10%.
Можно ли получить отчёт, который передать клиенту?Да. Команда /geo report-pdf создаёт профессиональный PDF с индикаторами оценки, диаграммами, визуализацией готовности платформ и приоритизированным планом действий. Команда /geo report даёт версию в формате markdown.
Бесплатен ли сам инструмент?Да, навык распространяется по лицензии MIT и бесплатен. Автор отдельно продаёт платное сообщество Skool, где учит превращать GEO-аудиты в бизнес по оказанию услуг клиентам.
What are similar projects?marketing-agi, marketingskills, open-seo-mcp-skills, jev-seo, linkedin-agent-skill, newsjack, Skill_Seekers, geo-score
Which topics is it in?seo-tools, schema, seo, marketing, ai-tools, analytics, claude-skills, web-scraping, chatgpt, skill, pdf, skills
Creator
zubair-trabzada
Size
0.3 MB
Stars
11.1K
Updated
CommitOct 05
Age
8mo
Commits · 90 Days