Geo Optimizer - Open-Source GEO/AEO Audit Tool

TL;DR

TL;DR: Geo Optimizer is a free, open-source CLI that audits your site against 47 research-backed AI visibility methods, checks whether ChatGPT, Perplexity, and Gemini actually cite you, and outputs the exact fixes needed — schema, llms.txt, robots.txt rules, and content patterns.

Source and Accuracy Notes

⚠️ This section is MANDATORY. All links must be verified from actual source, not guessed.

• Project page: geoready.dev
• Source repository: github.com/auriti-labs/geo-optimizer-skill
• Live demo: geoready.dev (free single-URL audit)
• Documentation: auriti-labs.github.io/geo-optimizer-skill
• License: MIT (verified via GitHub API license.spdx_id)
• HN launch thread: news.ycombinator.com/item?id=48873177 (via ai-visibility.pro Show HN)
• Stars: 584 (GitHub API, as of 2026-07-13)
• Source last checked: 2026-07-13 (commit main, pushed 2026-07-12)

What Is Geo Optimizer?

Geo Optimizer is an open-source Answer Engine Optimization (AEO) and Generative Engine Optimization (GEO) toolkit. It measures how visible your website is to AI answer engines — ChatGPT, Perplexity, Google AI Overviews, Gemini, and Claude — and tells you how to get cited by them.

The discipline goes by several names: AEO, GEO, AI SEO, LLM SEO, and AI visibility monitoring. Geo Optimizer covers all of them in one tool.

The key insight driving GEO in 2026: AI search engines give one synthesized answer and cite only a handful of sources. If your site is not cited, you are invisible — even if you rank number one on Google. The README cites a statistic that 28.3 percent of ChatGPT’s most-cited pages have zero organic visibility on Google, meaning traditional SEO and AEO reward fundamentally different signals.

Geo Optimizer scores your site against 47 research-backed methods drawn from academic work including Princeton KDD 2024 and AutoGEO ICLR 2026. It supports four run modes:

• CLI (Python package or uvx one-shot)
• Python library (import in your own code)
• MCP server (for AI agents like Claude Code)
• Astro integration

Setup Workflow

Prerequisites

• Python 3.9 or higher
• pip or uv

Option 1: pip install

pip install geo-optimizer-skill

Option 2: uvx one-shot (no install)

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

Option 3: MCP server

geo mcp

Then connect to the MCP endpoint in your AI agent tool.

Basic audit

# Score any site 0-100 against 8 AI-readiness categories
geo audit --url https://yoursite.com

# Audit a full sitemap
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

What the Audit Covers

Geo Optimizer evaluates your site across 8 scoring categories using 47 research-backed methods:

1. Full-site crawl inventory — audits homepage, product, pricing, case studies, docs, blog, sitemap, robots, and PDFs
2. Brand entity profile — clarifies who you are, what you offer, product boundaries, aliases, target customers, and disambiguation risks
3. Claim-level evidence ledger — maps every important claim to a source, verification status, freshness risk, and AI citation readiness
4. AI intent coverage matrix — checks whether your site answers recommendation, comparison, alternative, tutorial, pricing, risk, and buying queries
5. Technical crawlability audit — finds blockers in robots.txt, sitemap, canonical tags, status codes, JavaScript rendering, PDF text, image alt text, and internal links
6. Schema and structured data plan — recommends Organization, Product, Service, FAQ, Breadcrumb, Article, and CaseStudy markup opportunities
7. Trust signal gap analysis — reviews source blocks, update dates, authorship, company proof, certifications, compliance, customers, contact details, and correction paths
8. Competitor and off-site evidence map — compares where competitors have stronger public proof across media, reports, partners, communities, and app stores

Checking AI Citations

The geo citations command queries real AI engines with questions your customers ask, then reports whether your brand is mentioned and your domain is cited as a source — and which competitors get cited instead.

# Ask real AI engines: is my brand mentioned? Is my domain cited?
# Requires PERPLEXITY_API_KEY (recommended for real web citations)
geo citations --brand "YourBrand" --domain yoursite.com --topic "your product category"

# Save or query archived AI answer snapshots
geo snapshots --query "best GEO tool" --from 2026-03-01 --to 2026-03-30

Ongoing Monitoring

# Save history and detect regressions over time
geo audit --url https://yoursite.com --save-history --regression

# View saved trend for a site
geo history --url https://yoursite.com

# What changed since the last snapshot?
geo drift --url https://yoursite.com

# Run recurring monitoring and generate an HTML trend report
geo track --url https://yoursite.com --report --output ./geo-track-report.html

Open-Source vs GeoReady Platform

The CLI and web audit remain MIT-licensed and free. The GeoReady platform adds server-side continuity:

| | GEO Optimizer CLI | GeoReady.dev Free | GeoReady Pro/Studio/Agency | |---|---|---|---| | License | MIT, open-source | Free, no account | Self-serve | | Core use | Local audit, CI/CD, JSON output | Web audit, score preview | Monitoring, history, agency reporting | | Target | Developers, automation | Developers, SEO specialists | Multi-site portfolios | | Pricing | Free forever | Free forever | From $19/month |

FAQ

Q: Is this the same as traditional SEO? A: No. SEO optimizes for ranking and clicks in traditional search result pages. AEO/GEO measures whether an AI answer engine can read, parse, understand, and cite your content when generating a response. A site can rank well on Google and still be largely opaque to AI systems — missing structured data, no llms.txt, or bot access blocked.

Q: Do I need an API key to run the audit? A: The core audit commands (geo audit, geo diff, geo drift) do not require an API key. The geo citations command requires a Perplexity API key (PERPLEXITY_API_KEY) to query real AI engines for brand mentions.

Q: What Python version is required? A: Python 3.9 or higher.

Q: Can this run in CI/CD? A: Yes. The --fail-on warning flag makes geo drift return a non-zero exit code when regressions are detected, which works naturally in CI pipelines.

Conclusion

Geo Optimizer fills a specific gap that traditional SEO tools miss entirely: whether AI answer engines can actually cite your site, and what specifically blocks them from doing so. With 47 research-backed methods, MCP compatibility, and a Python library API, it integrates into both human workflows and AI agent pipelines. If you are publishing anything on the web in 2026, running an AEO audit alongside your regular SEO audit is worth doing — the signals are different, and the cost of being invisible to AI search while ranking well on Google is real.