Skip to content
Marketing
MCP

graft

Ships with geo-optimizer-skill: GEO Optimizer, the open-source engine behind GeoReady (geoready.dev): audit whether ChatGPT, Perplexity, Gemini & Google AI Overviews cite your site. CLI, Python, MCP.

From plugin
geo-optimizer-skill
1.2k1 skill10 agents2 MCP

Claude Code

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

Security report

Info

Not enough data

  • Known flaws

    Not published

  • Signed build

    Not published

  • Maintained

    Oct 30, 2026

    Last push

  • Licence

    MIT

  • Runs as

    Local process

    On your machine

  • Deprecated

    Not published

Signals from public registries, not an audit. Checked Nov 11, 2026.

geo-optimizer-skill README

GeoReady GEO Optimizer — Answer Engine Optimization toolkit

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.

PyPI Downloads/month GitHub Stars CI Python 3.10+ License: MIT

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:

Run the free web audit

The free web audit on geoready.dev: paste a URL, get a 0–100 GEO score, nine category results and the free fixes. Live run on geoready.dev, 17 October 2026: 94/100, Excellent.

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.

geo audit terminal dashboard on geoready.dev: 94/100 Excellent, nine rubric v2 categories with per-category scores, extra checks and top fixes

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.

Chart of 1,800+ audited sites: median GEO score 59 out of 100, average 56.5, 58% publish an llms.txt file, 76% ship JSON-LD structured data. Self-selected sample, 17 October 2026.

Chart of how 1,896 audited sites split across the GEO score bands: Foundation 57.6%, Good 28.2%, Critical 12.4%, Excellent 1.8%. Latest audit per domain, 17 October 2026; self-selected sample.

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.

geo fix on example.com: 9 fixes planned, estimated score 22/100 to 64/100

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

GEO Optimizer (this repo)geoready.dev FreeGeoReady Pro / Agency
AccessMIT, runs locallyWeb audit, no accountSelf-serve sign-up
Best forDevelopers, CI/CD, automationQuick checks, SEO specialistsOngoing clients, multi-site portfolios
What you getFull engine, JSON output, all 16 commandsSingle-URL score, free toolsMonitoring, score history, regression alerts, agency reporting
PriceFree foreverFree foreverFrom $19/month — pricing

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.

geo citations demo — is your brand cited by ChatGPT and Perplexity?

1.2k1 skill10 agents2 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
1.2k
Star history of Auriti-Labs/geo-optimizer-skill on GitHub, a chart by star-history.com

More MCP servers from other plugins.

NotFair

NotFair

MCP

Ships with notfair: Open-source SEO, GEO, and marketing skills for AI agents. The NotFair Plugin gives Claude Code, Codex,…

notfair1d4.1k
@nowork-studio@nowork-studioInstall MCP
NotFair

NotFair

MCP

Ships with notfair: Open-source SEO, GEO, and marketing skills for AI agents. The NotFair Plugin gives Claude Code, Codex,…

notfair1d4.1k
@nowork-studio@nowork-studioInstall MCP
medialyst

medialyst

MCP

Ships with newsjack: The open-source skills that turn your agent into a full PR team. Install once. Your agent — Claude Code,…

newsjack2w1.7k
@elvisun@elvisunInstall MCP

Questions about graft.

Which coding agents can use graft?
graft works in any agent that reads an MCP config file: Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf. Each agent reads it from its own file; this page names the file for each one.