MCP/auto-geo

auto-geo

Open-source GEO engine that audits, generates, rewrites, and tracks content citation visibility across ChatGPT, Claude, Gemini, and Perplexity.

seo•Generative Engine Optimization (GEO)

GitHub1.9k

License:MIT

COMMUNITY

@Shadow Research

About this Server

auto-geo is an open-source Generative Engine Optimization (GEO) engine built by Shadow Research. It provides an end-to-end automated workflow to audit web pages for AI citation readiness across 8 structural checks, generate publish-ready schema-backed articles, rewrite existing content into answer-first capsules, and measure whether AI search engines (Perplexity, OpenAI, Gemini, Grok) actually cite your domain for target prompts.

Real-time Interaction

Direct low-latency RPC protocol communication with structured JSON schemas.

Scoped Sandboxing

Restricted capability bounds to prevent accidental modifications or leakage.

Security & Best Practices

Local File-Based Workspace: All configurations, tracked prompt lists, and audit logs are stored in a committable local .auto-geo/ directory.

Zero Cloud Database Dependency: Does not require external accounts or third-party database connections to store audit history.

API Key Protection: LLM provider keys are loaded locally from .env.local and never committed to source control.

Safe Static Extraction: URL auditing retrieves public DOM structures without executing arbitrary client scripts.

When to Use (and When Not To)

Best For

•Brands and content marketing teams optimizing articles to be cited in ChatGPT, Perplexity, Claude, and Gemini
•Auditing existing blog posts and technical documentation for answer capsule structure and entity density
•Generating high-intent GEO pages with validated Article and FAQPage JSON-LD schemas
•Tracking citation coverage trends over time across multiple generative AI models

Not For / Limitations

•Traditional backlink building or keyword density analysis for legacy 2010 search algorithms
•Interactive browser DOM testing or end-to-end form clicking (use Playwright or Browser MCP instead)
•Real-time social posting or tweet publishing (use Twitter MCP instead)

Install & Setup

One-line terminal command

terminal command

$claude mcp add auto-geo -- npx -y auto-geo

Exposed Tools & Endpoints

6 tools

Functions your AI agent can invoke via this Model Context Protocol server

auto_geo_doctor• callable tool

Audit any web URL for AI citation readiness across 8 core checks including JSON-LD schemas, entity density, and question-format H2 headings.

auto_geo_write• callable tool

Generate publish-ready, structured JSON and Markdown pages optimized for AI extraction using answer capsules and strict GEO architecture.

auto_geo_fix• callable tool

Rewrite existing web content to conform to answer-first capsules and entity-dense GEO standards to pass citation audits.

auto_geo_check• callable tool

Query live AI engines (Perplexity, ChatGPT, Gemini, Claude, Grok) to measure whether your domain is cited for tracked prompts.

auto_geo_history• callable tool

Track historical citation coverage trends over time, showing newly cited or lost query prompts per engine.

auto_geo_prompts• callable tool

Manage tracked prompt lists and use AI discovery to propose high-intent queries to compete for in generative search answers.