English Français العربية

io.github.arthurcarlsonn/aeo-mcp

السجل الرسمي البحث والويب

AEO tools for AI agents: crawler permissions, llms.txt, structured data, AI-readiness audit.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package aeo-mcp
Claude Code 
claude mcp add aeo-mcp -- npx -y aeo-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "aeo-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "aeo-mcp@1.0.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. aeo-mcp
  2. Install
  3. Tools
  4. Try these prompts
  5. Security
  6. Development
  7. License

aeo-mcp

An MCP server that gives AI agents — Claude, Claude Code, Cursor, anything speaking the Model Context Protocol — tools to inspect a website's visibility to AI answer engines. Crawler permissions, llms.txt, structured data, on-page signals, and a full 29-check AI-readiness audit (powered by answer-audit), each one tool call away. Read-only, no API keys, no telemetry.

Real session: Claude Desktop discovers The Verge allows GPTBot (OpenAI licensing deal) while blocking ClaudeBot, PerplexityBot, Google-Extended, and CCBot — one tool call.

Install

Claude Code

claude mcp add aeo -- npx -y aeo-mcp

Claude Desktop (claude_desktop_config.json)

{ "mcpServers": { "aeo": { "command": "npx", "args": ["-y", "aeo-mcp"] } } }

Cursor (.cursor/mcp.json)

{ "mcpServers": { "aeo": { "command": "npx", "args": ["-y", "aeo-mcp"] } } }

Tools

ToolWhen the agent uses itInputReturns
audit_url"How visible is this site to ChatGPT/Perplexity?" — full AEO health check{ url }0-100 score, grade, category breakdown, failed/warned checks with fixes
check_ai_crawlers"Is GPTBot blocked?" — robots.txt policy per AI bot{ url }Per-bot allow/block verdicts with the matching rule, plus sitemaps
inspect_llms_txt"Does this site have llms.txt? Is it valid?"{ url }Title, summary, sections with links, structural issues, raw excerpt
extract_structured_data"What schema markup does this page have?"{ url }JSON-LD types, key fields per node, parse errors
extract_page_signals"Why do engines misread this page?"{ url }Title, meta description, h1, canonical, lang, text ratio, heading outline, client-side-rendering flag

Bots checked by check_ai_crawlers: GPTBot, ClaudeBot, PerplexityBot, Google-Extended, CCBot, Bingbot.

Try these prompts

  • "Audit glowlab.com and summarize the top 3 AEO fixes."
  • "Compare the AI crawler policies of nike.com and adidas.com — who is more open to being cited?"
  • "Check if my site has a valid llms.txt, and if not, draft one from my page signals."

Security

The server fetches model-supplied URLs, so it ships with an SSRF guard: http/https only, DNS resolution checked against private and special ranges (loopback, RFC1918, link-local, unique-local, IPv4-mapped forms), re-validation on every redirect hop, 10 s timeout, 2 MB body cap, max 5 redirects. Violations return a clean tool error, never an exception. All tools are read-only and no LLM calls happen inside the server.

Development

npm install
npm run build   # required before npm test (the protocol test runs dist/)
npm test

Tests include a scripted stdio round-trip (initialize → tools/list → tools/call) against the built server. To inspect interactively:

npx @modelcontextprotocol/inspector node dist/index.js

License

MIT © Arthur Carlson

الأسئلة الشائعة

ما هو io.github.arthurcarlsonn/aeo-mcp؟

AEO tools for AI agents: crawler permissions, llms.txt, structured data, AI-readiness audit.

كيف أثبّت io.github.arthurcarlsonn/aeo-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add aeo-mcp -- npx -y aeo-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.arthurcarlsonn/aeo-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.arthurcarlsonn/aeo-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.arthurcarlsonn/aeo-mcp؟

ينشره arthurcarlsonn. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.