{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/banner.svg\" alt=\"GEO-SEO Claude Code Skill\" width=\"900\"/>\n</p>\n\n<p align=\"center\">\n  <strong>GEO-first, SEO-supported.</strong> Optimize websites for AI-powered search engines<br/>\n  (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations.\n</p>\n\n<p align=\"center\">\n  AI search is eating traditional search. This tool optimizes for where traffic is going, not where it was.\n</p>\n\n---\n\n## Star History\n\n<a href=\"https://www.star-history.com/?type=date&repos=zubair-trabzada%2Fgeo-seo-claude\">\n <picture>\n   <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/chart?repos=zubair-trabzada/geo-seo-claude&type=date&theme=dark&legend=top-left\" />\n   <source media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/chart?repos=zubair-trabzada/geo-seo-claude&type=date&legend=top-left\" />\n   <img alt=\"Star History Chart\" src=\"https://api.star-history.com/chart?repos=zubair-trabzada/geo-seo-claude&type=date&legend=top-left\" />\n </picture>\n</a>\n\n---\n\n## Why GEO Matters (2026)\n\n| Metric | Value |\n|--------|-------|\n| GEO services market | $850M+ (projected $7.3B by 2031) |\n| AI-referred traffic growth | +527% year-over-year |\n| AI traffic conversion rate vs organic | 4.4x higher |\n| Gartner: search traffic drop by 2028 | -50% |\n| Brand mentions vs backlinks for AI | 3x stronger correlation |\n| Marketers investing in GEO | Only 23% |\n\n---\n\n## Quick Start\n\n### One-Command Install (macOS/Linux)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash\n```\n\n### Manual Install\n\n```bash\ngit clone https://github.com/zubair-trabzada/geo-seo-claude.git\ncd geo-seo-claude\n./install.sh\n```\n\n### Windows (Git Bash)\n\nRequires [Git for Windows](https://git-scm.com/downloads) which includes Git Bash.\n\n```bash\n# Option 1: One-command install (run from Git Bash, not PowerShell/CMD)\ncurl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install-win.sh | bash\n\n# Option 2: Manual install\ngit clone https://github.com/zubair-trabzada/geo-seo-claude.git\ncd geo-seo-claude\n./install-win.sh\n```\n\n> **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.\n\n### Requirements\n\n- Python 3.10+ (on Debian/Ubuntu also `python3-venv`)\n- Claude Code CLI\n- Git\n- Optional: [`uv`](https://docs.astral.sh/uv/) — if present, the installer uses it for a faster dependency install\n- Optional: Playwright (for screenshots)\n\n### Isolated install\n\nPython dependencies are installed into a dedicated virtual environment at\n`~/.claude/skills/geo/.venv/`. Your system Python is **not** touched, and\nuninstalling the skill removes the venv together with the rest of the files.\n\nSkill and agent files reference that venv directly, so the tool works\nregardless of what `python3` resolves to on your `PATH`.\n\n---\n\n## Commands\n\nOpen Claude Code and use these commands:\n\n| Command | What It Does |\n|---------|-------------|\n| `/geo audit <url>` | Full GEO + SEO audit with parallel subagents |\n| `/geo quick <url>` | 60-second GEO visibility snapshot |\n| `/geo citability <url>` | Score content for AI citation readiness |\n| `/geo crawlers <url>` | Check AI crawler access (robots.txt) |\n| `/geo llmstxt <url>` | Analyze or generate llms.txt |\n| `/geo brands <url>` | Scan brand mentions across AI-cited platforms |\n| `/geo platforms <url>` | Platform-specific optimization |\n| `/geo schema <url>` | Structured data analysis & generation |\n| `/geo technical <url>` | Technical SEO audit |\n| `/geo content <url>` | Content quality & E-E-A-T assessment |\n| `/geo report <url>` | Generate client-ready GEO report |\n| `/geo report-pdf` | Generate professional PDF report with charts & visualizations |\n\n---\n\n## Architecture\n\n```\ngeo-seo-claude/\n├── geo/                          # Main skill orchestrator\n│   └── SKILL.md                  # Primary skill file with commands & routing\n├── skills/                       # 13 specialized sub-skills\n│   ├── geo-audit/                # Full audit orchestration & scoring\n│   ├── geo-citability/           # AI citation readiness scoring\n│   ├── geo-crawlers/             # AI crawler access analysis\n│   ├── geo-llmstxt/              # llms.txt standard analysis & generation\n│   ├── geo-brand-mentions/       # Brand presence on AI-cited platforms\n│   ├── geo-platform-optimizer/   # Platform-specific AI search optimization\n│   ├── geo-schema/               # Structured data for AI discoverability\n│   ├── geo-technical/            # Technical SEO foundations\n│   ├── geo-content/              # Content quality & E-E-A-T\n│   ├── geo-report/               # Client-ready markdown report generation\n│   ├── geo-report-pdf/           # Professional PDF report with charts\n│   ├── geo-prospect/             # CRM-lite prospect pipeline management\n│   ├── geo-proposal/             # Auto-generate client proposals\n│   └── geo-compare/              # Monthly delta tracking & progress reports\n├── agents/                       # 5 parallel subagents\n│   ├── geo-ai-visibility.md      # GEO audit, citability, crawlers, brands\n│   ├── geo-platform-analysis.md  # Platform-specific optimization\n│   ├── geo-technical.md          # Technical SEO analysis\n│   ├── geo-content.md            # Content & E-E-A-T analysis\n│   └── geo-schema.md             # Schema markup analysis\n├── scripts/                      # Python utilities\n│   ├── fetch_page.py             # Page fetching & parsing\n│   ├── citability_scorer.py      # AI citability scoring engine\n│   ├── brand_scanner.py          # Brand mention detection\n│   ├── llmstxt_generator.py      # llms.txt validation & generation\n│   └── generate_pdf_report.py    # PDF report generator (ReportLab)\n├── schema/                       # JSON-LD templates\n│   ├── organization.json         # Organization schema (with sameAs)\n│   ├── local-business.json       # LocalBusiness schema\n│   ├── article-author.json       # Article + Person schema (E-E-A-T)\n│   ├── software-saas.json        # SoftwareApplication schema\n│   ├── product-ecommerce.json    # Product schema with offers\n│   └── website-searchaction.json # WebSite + SearchAction schema\n├── install.sh                    # One-command installer\n├── uninstall.sh                  # Uninstaller\n├── requirements.txt              # Python dependencies\n└── README.md                     # This file\n```\n\n---\n\n## Data Storage\n\nThe CRM and reporting skills (`/geo prospect`, `/geo proposal`, `/geo compare`) store runtime data outside the Claude Code directory:\n\n```\n~/.geo-prospects/\n├── prospects.json              # Client/prospect pipeline data\n├── proposals/                  # Generated proposal documents\n│   └── <domain>-proposal-<date>.md\n└── reports/                    # Monthly delta reports\n    └── <domain>-monthly-<YYYY-MM>.md\n```\n\nThis directory is **not removed** by the uninstaller — delete it manually if you no longer need your prospect data.\n\n---\n\n## How It Works\n\n### Full Audit Flow\n\nWhen you run `/geo audit https://example.com`:\n\n1. **Discovery** — Fetches homepage, detects business type, crawls sitemap\n2. **Parallel Analysis** — Launches 5 subagents simultaneously:\n   - AI Visibility (citability, crawlers, llms.txt, brand mentions)\n   - Platform Analysis (ChatGPT, Perplexity, Google AIO readiness)\n   - Technical SEO (Core Web Vitals, SSR, security, mobile)\n   - Content Quality (E-E-A-T, readability, freshness)\n   - Schema Markup (detection, validation, generation)\n3. **Synthesis** — Aggregates scores, generates composite GEO Score (0-100)\n4. **Report** — Outputs prioritized action plan with quick wins\n\n### Scoring Methodology\n\n| Category | Weight |\n|----------|--------|\n| AI Citability & Visibility | 25% |\n| Brand Authority Signals | 20% |\n| Content Quality & E-E-A-T | 20% |\n| Technical Foundations | 15% |\n| Structured Data | 10% |\n| Platform Optimization | 10% |\n\n---\n\n## Key Features\n\n### Citability Scoring\nAnalyzes content blocks for AI citation readiness. Optimal AI-cited passages are 134-167 words, self-contained, fact-rich, and directly answer questions.\n\n### AI Crawler Analysis\nChecks robots.txt for 14+ AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) and provides specific allow/block recommendations.\n\n### Brand Mention Scanning\nBrand mentions correlate 3x more strongly with AI visibility than backlinks. Scans YouTube, Reddit, Wikipedia, LinkedIn, and 7+ other platforms.\n\n### Platform-Specific Optimization\nOnly 11% of domains are cited by both ChatGPT and Google AI Overviews for the same query. Provides tailored recommendations per platform.\n\n### llms.txt Generation\nGenerates the emerging llms.txt standard file that helps AI crawlers understand your site structure.\n\n### Client-Ready Reports\nGenerates 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.\n\n---\n\n## Use Cases\n\n- **GEO Agencies** — Run client audits and generate deliverables\n- **Marketing Teams** — Monitor and improve AI search visibility\n- **Content Creators** — Optimize content for AI citations\n- **Local Businesses** — Get found by AI assistants\n- **SaaS Companies** — Improve entity recognition across AI platforms\n- **E-commerce** — Optimize product pages for AI shopping recommendations\n\n---\n\n## Uninstall\n\n```bash\n./uninstall.sh\n```\n\nOr manually:\n```bash\nrm -rf ~/.claude/skills/geo ~/.claude/skills/geo-* ~/.claude/agents/geo-*.md\n```\n\n---\n\n## Want to Turn This Into a Business?\n\nThe tool is free. Learning how to monetize it is where the community comes in.\n\n**[Join the AI Workshop Community →](https://skool.com/aiworkshop)**\n\nInside you'll get:\n- **Video walkthroughs** — Step-by-step setup, running audits, reading results\n- **Client acquisition playbook** — How to find prospects, pitch GEO services, and close deals\n- **Live office hours** — Bring your audit results, get direct help\n- **GEO agency pricing & templates** — Proposal docs, cold outreach scripts, onboarding workflows\n\nGEO agencies charge $2K–$12K/month. This tool does the audit. The community teaches you how to sell it.\n\n---\n\n\n\n\n\n## License\n\nMIT License\n\n---\n\n## Contributing\n\nContributions welcome!\n\n---\n\nBuilt for the AI search era.\n",
  "bytes": 10422,
  "sha": "6ee85c5466a3c4d5b5573f5055de275e5a0a5ca6298332b393942cd60930f687",
  "repo_slug": "zubair-trabzada/geo-seo-claude",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_zubair_trabzada_geo_seo_claude_geo_citab_fa317e27/readme"
}