geo

# GEO-SEO Analysis Tool — Claude Code Skill (February 2026) > **Philosophy:** GEO-first, SEO-supported. AI search is eating traditional search. > This tool optimizes for where traffic is going, not where it was. --- ## Quick Reference | Command | What It Does | |---------|-------------| | `/geo audit <url>` | Full GEO + SEO audit with parallel subagents | | `/geo page <url>` | Deep single-page GEO analysis | | `/geo citability <url>` | Score content for AI citation readiness | | `/geo crawlers <url>` | Check AI crawler access (robots.txt analysis) | | `/geo llmstxt <url>` | Analyze or generate llms.txt file | | `/geo brands <url>` | Scan brand mentions across AI-cited platforms | | `/geo platforms <url>` | Platform-specific optimization (ChatGPT, Perplexity, Google AIO) | | `/geo schema <url>` | Detect, validate, and generate structured data | | `/geo technical <url>` | Traditional technical SEO audit | | `/geo content <url>` | Content quality and E-E-A-T assessment | | `/geo report <url>` | Generate client-ready GEO deliverable | | `/geo report-pdf <url>` | Generate professional PDF report with charts and scores | | `/geo quick <url>` | 60-second GEO visibility snapshot | --- ## Market Context (Why GEO Matters) | Metric | Value | Source | |--------|-------|--------| | GEO services market (2025) | $850M-$886M | Yahoo Finance / Superlines | | Projected GEO market (2031) | $7.3B (34% CAGR) | Industry analysts | | AI-referred sessions growth | +527% (Jan-May 2025) | SparkToro | | AI traffic conversion vs organic | 4.4x higher | Industry data | | Google AI Overviews reach | 1.5B users/month, 200+ countries | Google | | ChatGPT weekly active users | 900M+ | OpenAI | | Perplexity monthly queries | 500M+ | Perplexity | | Gartner: search traffic drop by 2028 | -50% | Gartner | | Marketers investing in GEO | Only 23% | Industry surveys | | Brand mentions vs backlinks for AI | 3x stronger correlation | Ahrefs (Dec 2025) | --- ## Orchestration Logic ### Full Audit (`/geo audit <url>`) **Phase 1: Discovery (Sequential)** 1. Fetch homepage HTML (curl or WebFetch) 2. Detect business type (SaaS, Local, E-commerce, Publisher, Agency, Other) 3. Extract key pages from sitemap.xml or internal links (up to 50 pages) **Phase 2: Parallel Analysis (Delegate to Subagents)** Launch these 5 subagents simultaneously: | Subagent | File | Responsibility | |----------|------|---------------| | geo-ai-visibility | `agents/geo-ai-visibility.md` | GEO audit, citability, AI crawlers, llms.txt, brand mentions | | geo-platform-analysis | `agents/geo-platform-analysis.md` | Platform-specific optimization (ChatGPT, Perplexity, Google AIO) | | geo-technical | `agents/geo-technical.md` | Technical SEO, Core Web Vitals, crawlability, indexability | | geo-content | `agents/geo-content.md` | Content quality, E-E-A-T, readability, AI content detection | | geo-schema | `agents/geo-schema.md` | Schema markup detection, validation, generation | **Phase 3: Synthesis (Sequential)** 1. Collect all subagent reports 2. Calculate composite GEO Score (0-100) 3. Generate prioritized action plan 4. Output client-ready report ### Scoring Methodology | Category | Weight | Measured By | |----------|--------|-------------| | AI Citability & Visibility | 25% | Passage scoring, answer block quality, AI crawler access | | Brand Authority Signals | 20% | Mentions on Reddit, YouTube, Wikipedia, LinkedIn; entity presence | | Content Quality & E-E-A-T | 20% | Expertise signals, original data, author credentials | | Technical Foundations | 15% | SSR, Core Web Vitals, crawlability, mobile, security | | Structured Data | 10% | Schema completeness, JSON-LD validation, rich result eligibility | | Platform Optimization | 10% | Platform-specific readiness (Google AIO, ChatGPT, Perplexity) | --- ## Business Type Detection Analyze homepage for patterns: | Type | Signals | |------|---------| | **SaaS** | Pricing page, "Sign up", "Free trial", "/app", "/dashboard", API docs | | **Local Service** | Phone number, address, "Near me", Google Maps embed, service area | | **E-commerce** | Product pages, cart, "Add to cart", price elements, product schema | | **Publisher** | Blog, articles, bylines, publication dates, article schema | | **Agency** | Portfolio, case studies, "Our services", client logos, testimonials | | **Other** | Default — apply general GEO best practices | Adjust recommendations based on detected type. Local businesses need LocalBusiness schema and Google Business Profile optimization. SaaS needs SoftwareApplication schema and comparison page strategy. E-commerce needs Product schema and review aggregation. --- ## Sub-Skills (10 Specialized Components) | # | Skill | Directory | Purpose | |---|-------|-----------|---------| | 1 | geo-audit | `skills-db/geo/geo-audit/` | Full audit orchestration and scoring | | 2 | geo-citability | `skills-db/geo/geo-citability/` | Passage-level AI citation readiness | | 3 | geo-crawlers | `skills-db/geo/geo-crawlers/` | AI crawler access and robots.txt | | 4 | geo-llmstxt | `skills-db/geo/geo-llmstxt/` | llms.txt standard analysis and generation | | 5 | geo-brand-mentions | `skills-db/geo/geo-brand-mentions/` | Brand presence on AI-cited platforms | | 6 | geo-platform-optimizer | `skills-db/geo/geo-platform-optimizer/` | Platform-specific AI search optimization | | 7 | geo-schema | `skills-db/geo/geo-schema/` | Structured data for AI discoverability | | 8 | geo-technical | `skills-db/geo/geo-technical/` | Technical SEO foundations | | 9 | geo-content | `skills-db/geo/geo-content/` | Content quality and E-E-A-T | | 10 | geo-report | `skills-db/geo/geo-report/` | Client-ready deliverable generation | --- ## Subagents (5 Parallel Workers) | Agent | File | Skills Used | |-------|------|-------------| | geo-ai-visibility | `agents/geo-ai-visibility.md` | geo-citability, geo-crawlers, geo-llmstxt, geo-brand-mentions | | geo-platform-analysis | `agents/geo-platform-analysis.md` | geo-platform-optimizer | | geo-technical | `agents/geo-technical.md` | geo-technical | | geo-content | `agents/geo-content.md` | geo-content | | geo-schema | `agents/geo-schema.md` | geo-schema | --- ## Output Files All commands generate structured output: | Command | Output File | |---------|------------| | `/geo audit` | `GEO-AUDIT-REPORT.md` | | `/geo page` | `GEO-PAGE-ANALYSIS.md` | | `/geo citability` | `GEO-CITABILITY-SCORE.md` | | `/geo crawlers` | `GEO-CRAWLER-ACCESS.md` | | `/geo llmstxt` | `llms.txt` (ready to deploy) | | `/geo brands` | `GEO-BRAND-MENTIONS.md` | | `/geo platforms` | `GEO-PLATFORM-OPTIMIZATION.md` | | `/geo schema` | `GEO-SCHEMA-REPORT.md` + generated JSON-LD | | `/geo technical` | `GEO-TECHNICAL-AUDIT.md` | | `/geo content` | `GEO-CONTENT-ANALYSIS.md` | | `/geo report` | `GEO-CLIENT-REPORT.md` (presentation-ready) | | `/geo report-pdf` | `GEO-REPORT.pdf` (professional PDF with charts) | | `/geo quick` | Inline summary (no file) | --- ## PDF Report Generation The `/geo report-pdf <url>` command generates a professional, branded PDF report: ### How It Works 1. Run the full audit or individual analyses first 2. Collect all scores and findings into a JSON structure 3. Execute the PDF generator: `python3 ~/.agents/skills-db/geo/geo/scripts/generate_pdf_report.py data.json GEO-REPORT.pdf` ### What the PDF Includes - **Cover page** with GEO score gauge visualization - **Score breakdown** with color-coded bar charts - **AI Platform Readiness** dashboard with horizontal bar chart - **Crawler Access** status table with color-coded Allow/Block - **Key Findings** categorized by severity (Critical/High/Medium/Low) - **Prioritized Action Plan** (Quick Wins, Medium-Term, Strategic) - **Methodology & Glossary** appendix ### Workflow 1. First run `/geo audit <url>` to collect all data 2. Then run `/geo report-pdf <url>` to generate the PDF 3. The tool will compile audit data into JSON, then generate the PDF 4. Output: `GEO-REPORT.pdf` in the current directory --- ## Quality Gates - **Crawl limit:** Max 50 pages per audit (focus on quality over quantity) - **Timeout:** 30 seconds per page fetch - **Rate limiting:** 1-second delay between requests, max 5 concurrent - **Robots.txt:** Always respect, always check - **Duplicate detection:** Skip pages with >80% content similarity --- ## Quick Start Examples ``` # Full GEO audit of a website /geo audit https://example.com # Check if AI bots can see your site /geo crawlers https://example.com # Score a specific page for AI citability /geo citability https://example.com/blog/best-article # Generate an llms.txt file for your site /geo llmstxt https://example.com # Get a 60-second visibility snapshot /geo quick https://example.com # Generate a client-ready report /geo report https://example.com ```