geo-optimizer

Your site ranks on Google. Does ChatGPT cite it?

The open-source Answer Engine Optimization (AEO) & Generative Engine Optimization (GEO) toolkit.

GEO Optimizer is the open-source engine behind GeoReady, the hosted AI visibility audit at geoready.dev. Run it here from the terminal, or in the browser on geoready.dev.

One command scores any website 0–100 on whether ChatGPT, Perplexity, Gemini, Claude, and Google AI Overviews can crawl it, understand it, and cite it — then tells you exactly what to fix.

uvx --from geo-optimizer-skill geo audit --url https://yoursite.com

No install, no account, no API key. Runs in seconds.

No terminal? Paste your URL into the browser version instead. Same engine, free, no account:

The browser audit on geoready.dev: paste a URL, read the score, the nine category results and the free fixes. Live run on geoready.dev itself, 17 October 2026.

Quick Start · Free web audit, no account · Docs · The book · Changelog

What is GEO Optimizer?

GEO Optimizer measures how visible a website is to AI answer engines — ChatGPT, Perplexity, Google AI Overviews, Gemini, and Claude — scores it 0–100, and generates the fixes. It is free, MIT-licensed, and runs as a CLI, a Python library, an MCP server, a GitHub Action, or an Astro integration.

Also called GEO, AI SEO, or LLM SEO — same problem: an answer engine gives one response and cites a handful of sources. Ranking on Google does not make you one of them. Being reachable, parseable, and quotable does.

16 CLI commands · 9 scoring categories · 27 AI crawlers checked · 47 content checks · 12 MCP tools · 8 output formats · 2,000+ tests

What a real audit looks like

Two runs of geo audit, September 2026. example.com has no robots.txt, no llms.txt, and no structured data. geoready.dev is built with this engine's own Astro integration. Excerpts, condensed from the full text output.

[█░░░░░░░░░░░░░░░░░░░] 8/100
❌ CRITICAL — Site is not visible
   to AI search engines

📋 PRIORITY NEXT STEPS:
1. Create robots.txt with Allow rules
   for AI bots (GPTBot, ClaudeBot,
   PerplexityBot)
2. Create /llms.txt for AI indexing
3. Add WebSite JSON-LD schema
4. Add Organization JSON-LD schema
5. Add FAQPage schema with site FAQs

[██████████████████░░] 91/100
🏆 EXCELLENT

✅ 27/27 AI crawlers allowed
✅ llms.txt found (~3554 words)
✅ 7 schema types
✅ 0 prompt-injection patterns
✅ 1/4 Knowledge Graph pillars
⚠️  No dateModified signal
   (Wikipedia, Wikidata, LinkedIn,
   Crunchbase)

Across 1,800+ sites audited through GeoReady (latest audit per domain, as of 17 October 2026), the median score is 59/100, 58% publish an llms.txt and 76% ship JSON-LD structured data. 58% of them land in the Foundation band (36–67), 28% in Good, 12% in Critical and 2% in Excellent. Scores mix rubric v1 (engine 4.13 to 4.18) and v2 (4.19). The sample is self-selected (people who chose to audit their site), so treat it as directional, not a census of the web.

Where does your site land? Run the free audit and compare your score with the median, or run geo audit above.

Then it writes the fixes

geo fix turns the audit into files: robots.txt rules for all 27 AI bots, llms.txt, JSON-LD schema, AI discovery endpoints, and meta tags. It previews by default and writes only with --apply. The score after fixes is the tool's own estimate, not a measured result.

Prefer no terminal? Run the same audit free at geoready.dev — no account needed.

Quick Start

# Zero install
uvx --from geo-optimizer-skill geo audit --url https://yoursite.com

# Or install it
pip install -U geo-optimizer-skill

geo audit --url https://yoursite.com                   # score 0–100 + prioritized fixes
geo fix --url https://yoursite.com                     # preview robots.txt, llms.txt, schema, meta (--apply to write)
geo audit --url https://yoursite.com --threshold 70    # exit 1 below 70 — use it as a CI gate
geo citations --brand "Acme" --domain acme.com         # does AI cite you? (bring your own API key)

All 16 commands

# Audit a full sitemap and surface the weakest pages first
geo audit --sitemap https://yoursite.com/sitemap.xml --max-urls 25

# Compare before/after versions of a page
geo diff --before https://yoursite.com/page-old --after https://yoursite.com/page-new

# Save history, detect regressions, and show the trend
geo audit --url https://yoursite.com --save-history --regression
geo history --url https://yoursite.com

# What changed since the last snapshot? (CI: --fail-on warning)
geo drift --url https://yoursite.com

# Passive AI visibility snapshot for a domain
geo monitor --domain yoursite.com

# Ask real AI engines whether your brand is mentioned and your domain cited.
# AI answers vary run to run — sample each query 5x for a confidence interval.
geo citations --brand "YourBrand" --domain yoursite.com --topic "your product category" --runs 5

# Save or query archived AI answer snapshots, and score citation quality in one
geo snapshots --query "best GEO tool" --from 2026-03-01 --to 2026-03-30
geo snapshots --quality --snapshot-id 12 --target-domain yoursite.com

# Recurring monitoring with an HTML trend report
geo track --url https://yoursite.com --report --output ./geo-track-report.html

# Generate llms.txt from the sitemap, or check an existing one for stale URLs (exit 1)
geo llms --base-url https://yoursite.com --output ./public/llms.txt
geo llms --base-url https://yoursite.com --check-drift

# Generate or analyze JSON-LD schema
geo schema --type website --name "Your Site" --url https://yoursite.com
geo schema --file index.html --analyze

# Site-level and diagnostic tools
geo coherence --sitemap https://yoursite.com/sitemap.xml   # cross-page terminology consistency
geo authority --sitemap https://yoursite.com/sitemap.xml   # topical authority: clusters, pillars, depth
geo logs --file access.log                                  # AI crawler activity from server logs
geo access --url https://yoursite.com                       # browser vs AI-bot access simulation
geo perception --url https://yoursite.com                   # what an AI would extract from the page

Guides for most commands live in docs/. Provider setup for geo citations (Perplexity, OpenAI, Anthropic, Groq, Gemini, MiniMax, DeepSeek, and SerpBase for the real Google SERP + AI Overview): docs/llm-providers.md.

After the one-shot audit

geo audit is a snapshot. It can't tell you that your score dropped after last Tuesday's deploy, or whether citations started appearing once your fixes shipped. geo history, geo drift, and geo track help — but only when someone remembers to run them.

The hosted platform runs the same engine on a schedule, so the watching happens without you:

• Free plan — audits, your last 5 reports, and one real AI answer check a week (Perplexity).
• Pro / Agency, from $19/mo — weekly score monitoring, regression alerts, multi-site portfolios, client reporting. Pricing.

Create a free account · Free web audit, no account · Get the free 160-page GEO Readiness Manual

Same engine everywhere: the platform adds what a local CLI cannot — server-side monitoring, history, and team features.

Open source vs hosted — the full comparison

Is AI citing you? Ask it directly.

geo citations sends the questions your customers ask to real answer engines, then reports whether your brand is mentioned, whether your domain is cited as a source, and which competitors are cited instead.