GEO Optimizer

Make websites visible and citable by AI search engines (ChatGPT Search, Perplexity, Claude, Gemini AI Overviews). Implements the GEO audit framework plus a 47-method citability engine based on Princeton KDD 2024 research.

Workflow

Step 1 — Audit the site

Run geo audit first. It scores the site 0–100 across 9 categories and generates a prioritized action list.

geo audit --url https://yoursite.com
geo audit --url https://yoursite.com --format json
geo audit --sitemap https://yoursite.com/sitemap.xml --max-urls 25

Score bands: 0–35 critical · 36–67 foundation · 68–85 good · 86–100 excellent.

Step 2 — Fix AI crawler access (robots.txt)

Ensure AI citation bots can reach the site. Critical bots that must never be blocked:

• OAI-SearchBot — ChatGPT Search citations
• PerplexityBot — Perplexity answer citations
• ClaudeBot — Claude web citations
• Google-Extended — Gemini AI Overviews

To allow citations while blocking training: Disallow: / for GPTBot and anthropic-ai, but keep Allow: / for OAI-SearchBot, ClaudeBot, PerplexityBot.

Step 3 — Generate llms.txt

/llms.txt tells AI crawlers what the site is about and which pages matter.

geo llms --base-url https://yoursite.com --site-name "Site Name" --description "One-sentence description." --output ./public/llms.txt

Required structure: H1 (site name) → blockquote (description) → H2 sections with descriptive links. Keep under 200 lines. Full spec: https://llmstxt.org

Step 4 — Inject JSON-LD schema

Add structured data so AI engines understand page types:

geo schema --type website --url https://yoursite.com
geo schema --type faq --url https://yoursite.com/faq
geo schema --type webapp --url https://yoursite.com/tool

Types: website, webapp, faq, article, organization, breadcrumb.

Step 5 — Optimize content (Princeton GEO methods)

Apply evidence-based improvements ordered by measured impact:

Source: Princeton KDD 2024 (10,000 queries on Perplexity.ai). Extended by AutoGEO ICLR 2026, SE Ranking 2025, Growth Marshal 2026 to 47 total methods.

Step 6 — Auto-fix all gaps

Generate all missing files at once:

geo fix --url https://yoursite.com --apply
geo fix --url https://yoursite.com --only robots,llms,schema

Creates robots.txt entries, llms.txt, JSON-LD schema, meta tags, and AI discovery endpoints based on audit results.

Scoring

9 categories, 100 points total in rubric v2:

Google AI readiness checks

Each check includes its Google source URL in audit JSON and recommendations:

• G-INDEX (5): final status 200; no meta robots, googlebot, or X-Robots-Tag noindex; Googlebot is not blocked by robots.txt. Source: https://developers.google.com/search/docs/essentials/technical
• G-SNIPPET (5): no nosnippet, max-snippet:0, or max-snippet below 50; max-image-preview:none warns; data-nosnippet over 50% fails and over 10% warns. Source: https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag
• G-CANONICAL (3): exactly one absolute canonical in <head>, matching the final URL. Source: https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls
• G-DATES (2): visible date agrees with datePublished/dateModified and no date is in the future. Source: https://developers.google.com/search/docs/appearance/publication-dates
• G-BYLINE (2): visible author or JSON-LD author, ideally linked to an author page. Source: https://developers.google.com/search/docs/fundamentals/creating-helpful-content
• G-LINKS (1): internal links use crawlable <a href> elements and no #/ routes. Source: https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics
• G-VIEWPORT (1): a meta viewport is present. Source: https://developers.google.com/search/docs/appearance/page-experience
• G-SITEMAP (1): a Sitemap directive is declared in robots.txt. Source: https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap
• G-SD-VISIBLE (2 in schema): JSON-LD name or headline appears in visible text. Source: https://developers.google.com/search/docs/appearance/structured-data/sd-policies
• G-GENAI-CONTROL (0, manual): check Search Console generative-AI opt-out. Source: https://developers.google.com/search/docs/fundamentals/ai-optimization-guide

llms.txt is useful to other AI agents but is ignored by Google Search. The score is versioned: JSON exposes score_version and per-category score_max; use geo audit --score-version 1 for legacy v1 comparisons. History deltas and regressions compare snapshots only when their score_version matches.

CLI Commands

11 commands covering audit, remediation, analysis, and monitoring:

# ── Primary ──
geo audit    --url URL [--format text|json|rich|html|github|ci|pdf] [--sitemap URL]
geo fix      --url URL [--apply] [--only robots,llms,schema,meta,ai_discovery,content]
geo llms     --base-url URL --site-name NAME --description DESC --output FILE
geo schema   --type TYPE --url URL [--inject FILE]

# ── Analysis ──
geo diff       --before URL --after URL
geo history    --url URL
geo coherence  --url URL

# ── Monitoring ──
geo monitor  --domain DOMAIN
geo track    --url URL [--report] [--output FILE]

# ── Utility ──
geo logs       --path LOGFILE
geo snapshots  --url URL [--save | --compare SNAPSHOT_ID]

Output Formats

7 formats for different workflows:

Informational Checks

10 non-scoring checks that provide deeper analysis beyond the 0–100 score:

MCP Integration

12 tools and 5 resources for Claude Code, Cursor, Windsurf, and any MCP client:

Tools:

Resources: geo://ai-bots · geo://score-bands · geo://methods · geo://changelog · geo://ai-discovery-spec

Plugin System

Extend the audit with custom checks via entry points:

# pyproject.toml
[project.entry-points."geo_optimizer.checks"]
my_check = "my_package:MyCheck"

Plugins implement the AuditCheck protocol (name, description, max_score, run()). Plugin results appear in the audit output but do not affect the base score.

Platform Context Files

Platform-optimized versions of this skill for different AI tools:

# Quick copy commands
mkdir -p .cursor/rules && cp ai-context/cursor.mdc .cursor/rules/geo-optimizer.mdc
mkdir -p .windsurf/rules && cp ai-context/windsurf.md .windsurf/rules/geo-optimizer.md
mkdir -p .kiro/steering && cp ai-context/kiro-steering.md .kiro/steering/geo-optimizer.md

---

GEO Optimizer by Juan Camilo Auriti — https://github.com/auriti-labs/geo-optimizer-skill