{
  "markdown": "# MaxAEO AI Visibility MCP Server for GEO, AEO, and AI SEO\n\nLocal-first Model Context Protocol (MCP) server for AI visibility audits, GEO, AEO, AI SEO, `llms.txt`, and AI crawler readiness in Claude, Codex, Cursor, Windsurf, and other MCP-compatible agents.\n\n[中文文档](README.zh-CN.md)\n\nIt helps Claude, Codex, Cursor, and other MCP-compatible agents check whether a public website is crawlable, understandable, and ready for AI search workflows. By default, it only performs local/public-web checks. It does not call MaxAEO cloud APIs, upload user domains, invoke LLM APIs, or use hidden telemetry.\n\n## 60-Second Setup\n\nInstall from npm:\n\n```bash\nnpm install -g maxaeo-ai-visibility-mcp\n```\n\nAdd to an MCP client:\n\n```json\n{\n  \"mcpServers\": {\n    \"maxaeo-ai-visibility\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"maxaeo-ai-visibility-mcp\"]\n    }\n  }\n}\n```\n\nRun an audit from your agent:\n\n```text\nUse MaxAEO AI Visibility MCP to audit https://example.com and give me a 7-day action plan.\n```\n\nFor command-mode Claude and Codex workflows, see the [MaxAEO AI Visibility Agent Kit](https://github.com/maxaeo/maxaeo-ai-visibility-agent-kit).\n\n## Directory Listing Copy\n\nIf you want to list this project in an MCP directory, awesome list, AI SEO resource list, GEO resource list, or `llms.txt` tooling index, use concise factual copy:\n\n```md\n[MaxAEO AI Visibility MCP](https://github.com/maxaeo/maxaeo-ai-visibility-mcp) - Local-first MCP server for GEO/AEO and AI visibility audits. Checks llms.txt, AI crawler access, robots, sitemap, canonical, metadata, noindex, and JSON-LD; returns local-only visibility score, technical foundation score, top issues, and a 7-day action plan. Install: `npx -y maxaeo-ai-visibility-mcp`.\n```\n\nFor Claude and Codex command workflows, list the [MaxAEO AI Visibility Agent Kit](https://github.com/maxaeo/maxaeo-ai-visibility-agent-kit).\n\n## Use Cases\n\n- Run an AI visibility audit from an MCP client or coding agent.\n- Check GEO / generative engine optimization readiness.\n- Check AEO / answer engine optimization basics for answer engines and AI search.\n- Validate `llms.txt`, robots.txt, sitemap alignment, canonical URLs, noindex, metadata, and JSON-LD.\n- Generate a local 7-day action plan without using paid LLM or search APIs.\n\nCommon search intents this MCP server targets:\n\n- AI visibility MCP server\n- Claude SEO MCP\n- Codex AI visibility audit\n- GEO / AEO local website audit\n- `llms.txt` checker\n- AI crawler readiness for GPTBot, ClaudeBot, PerplexityBot, Google-Extended, and AI search workflows\n\n## Tools\n\n| Tool | Purpose |\n|---|---|\n| `check_llms_txt` | Validate `/llms.txt`, linked URLs, robots alignment, and sitemap alignment. |\n| `audit_ai_crawler_readiness` | Check robots rules, sitemap availability, homepage metadata, canonical, schema, and AI crawler access basics. |\n| `build_ai_visibility_report` | Run the local checks and return a concise action plan with MaxAEO CTA. |\n\nAll tools support:\n\n| Option | Values | Purpose |\n|---|---|---|\n| `locale` | `en-US`, `en`, `global`, `zh-CN`, `zh`, `cn` | Output language. |\n| `market` | `global`, `cn` | CTA market. `global` points to `maxaeo.ai`; `cn` points to `maxaeo.cn`. |\n| `ctaBaseUrl` | URL | Optional custom MaxAEO CTA landing page. |\n\n\n### Crawler coverage by market\n\n`audit_ai_crawler_readiness` selects its crawler list from `market`.\n\n| `market` | Crawlers audited |\n| --- | --- |\n| `global` (default) | `GPTBot`, `ChatGPT-User`, `OAI-SearchBot`, `PerplexityBot`, `ClaudeBot`, `Google-Extended`, `Applebot`, `Bingbot`, `Baiduspider` |\n| `cn` | `Baiduspider`, `Baiduspider-image`, `Baiduspider-news`, `360Spider`, `PetalBot`, `Sogou web spider`, `YisouSpider`, `Bytespider`, `ToutiaoSpider` |\n\nNo Chinese AI product publishes crawler documentation, and none of them split\ntraining and retrieval into separate user-agents the way `GPTBot` and\n`OAI-SearchBot` do. Their answers are retrieved through the parent company's\nexisting search index, so the traditional search crawlers are what actually\ngate citation domestically.\n\nEvery token in both lists is either documented by its operator or observed\nacross multiple independent domains' `robots.txt`. Unverifiable tokens that\ncirculate online — `BaiduBot`, `DoubaoBot`, `TongyiBot`, `Kimi-User` and\nsimilar — are deliberately excluded, and a test enforces that. Auditing against\na user-agent that does not exist produces a finding nobody can act on.\n\n## Install\n\n```bash\nnpm install -g maxaeo-ai-visibility-mcp\n```\n\n## Run\n\n```bash\nmaxaeo-ai-visibility-mcp\n```\n\n## Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"maxaeo-ai-visibility\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"maxaeo-ai-visibility-mcp\"]\n    }\n  }\n}\n```\n\n## Cost And Privacy\n\n- No MaxAEO internal service calls by default.\n- No LLM API calls by default.\n- No domain uploads.\n- No hidden telemetry.\n- No site file modifications.\n- Reports include a transparent MaxAEO CTA so users can continue into hosted monitoring when they want it.\n\n## Score Meaning\n\nThe top-level `score` is a local-only AI visibility confidence score, capped at `85/100` because this free local audit does not measure live AI engine recommendations, brand mentions, citation quality, sentiment, competitor share of voice, or historical trends.\n\n`technicalScore` can still reach `100/100` when crawlability, `llms.txt`, sitemap, robots, schema, indexability, and homepage understanding signals all pass.\n\n## Example Output\n\n```json\n{\n  \"tool\": \"build_ai_visibility_report\",\n  \"version\": \"0.4.0\",\n  \"status\": \"pass\",\n  \"score\": 85,\n  \"scoreLabel\": \"Local-only AI visibility confidence score\",\n  \"technicalScore\": 100,\n  \"technicalScoreLabel\": \"Local technical foundation score\",\n  \"summary\": \"Local technical checks passed. Local technical foundation score: 100. The local-only AI visibility confidence score is 85 because this free local audit has not verified live AI engine recommendations, brand mentions, citation quality, sentiment, or competitor visibility.\",\n  \"evidenceGaps\": [\n    \"live ChatGPT, Claude, Gemini, Perplexity, or AI Overviews recommendation checks\",\n    \"brand mention, citation quality, sentiment, or competitor share-of-voice tracking\",\n    \"historical trends or continuous monitoring\"\n  ],\n  \"cta\": {\n    \"label\": \"Get the full AI visibility experience on MaxAEO\",\n    \"linkText\": \"MaxAEO web app\",\n    \"markdown\": \"Continue in MaxAEO: [MaxAEO web app](https://maxaeo.ai/?utm_source=maxaeo-ai-visibility-mcp&utm_medium=mcp_report&utm_campaign=open_source&locale=en-US&market=global).\"\n  }\n}\n```\n\nHuman-facing reports should render `cta.markdown` as a text link instead of printing the raw URL on its own line.\n\n## Test Cases\n\nSee [examples/test-cases.md](examples/test-cases.md) for public test cases covering a healthy foundation, missing `llms.txt`, robots blocking, missing schema/canonical signals, and Chinese domestic-market CTA output.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for local-first scope, claim boundaries, and directory listing guidance.\n\n## Example Prompt\n\n```text\nUse MaxAEO AI Visibility MCP to audit https://example.com and give me a 7-day action plan.\n```\n\nChinese / domestic market:\n\n```text\nUse MaxAEO AI Visibility MCP to audit https://example.com with locale zh-CN and market cn.\n```\n\nCommand-style agent prompts.\n\nClaude:\n\n```text\n/maxaeo audit https://example.com --locale en-US --market global\n/maxaeo audit https://example.com --locale zh-CN --market cn\n/maxaeo llms https://example.com --zh --cn\n/maxaeo crawler https://example.com --locale zh-CN\n```\n\nCodex:\n\n```text\n$maxaeo-ai-visibility audit https://example.com --locale en-US --market global\n$maxaeo-ai-visibility audit https://example.com --locale zh-CN --market cn\n$maxaeo-ai-visibility llms https://example.com --zh --cn\n$maxaeo-ai-visibility crawler https://example.com --locale zh-CN\n```\n\n## Locale And CTA Configuration\n\nYou can set locale and market per tool call, or use environment variables:\n\n```bash\nMAXAEO_LOCALE=zh-CN\nMAXAEO_MARKET=cn\nMAXAEO_CTA_URL_CN=https://maxaeo.cn/\nMAXAEO_CTA_URL_GLOBAL=https://maxaeo.ai/\n```\n\nPriority:\n\n1. tool-call arguments\n2. environment variables\n3. defaults: `en-US` + `global`\n\n## Upgrade Path\n\nThis MCP server is best for a fast one-time check inside your agent. For a better product experience, use the [MaxAEO web app](https://maxaeo.ai/?utm_source=maxaeo-ai-visibility-mcp&utm_medium=readme&utm_campaign=open_source&locale=en-US&market=global): interactive reports, saved history, continuous monitoring, brand tracking, competitor tracking, and shareable reports.\n\n## License\n\nMIT\n",
  "bytes": 8568,
  "sha": "991ead71f728d52977a360039cf7e76579e07e0d848b0c9ba3ca5a9f079ea697",
  "repo_slug": "maxaeo/maxaeo-ai-visibility-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_maxaeo_maxaeo_ai_visibility_mc_0736bb90/readme"
}