MCP 与 API

在 Claude、您的智能体和流水线中评估 AI 可见性。

AeoState 在 https://aeostate.com/mcp 运行 Model Context Protocol（MCP）服务器，背后是同一套 HTTP API。连接一次，免费的 AI 可见性评分就会以交互式卡片显示在 Claude Desktop、claude.ai、Claude Code、Cursor 及其他所有 MCP 主机中——也可以直接从脚本调用 API。

工具

免费工具人人可用——无需账户和密钥。标有“API 密钥”的工具代表已注册账户运行：创建免费账户，然后在“账户 → API 访问”中创建个人密钥。

一步连接

把下面任一片段复制到您的主机中。拥有密钥后，加上 Authorization 请求头。

MCP 端点
https://aeostate.com/mcp
Claude Code
claude mcp add --transport http aeostate https://aeostate.com/mcp
Cursor、VS Code、claude.ai 连接器及其他主机（JSON）
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp"
    }
  }
}
同上，以您的账户身份运行
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

面向流水线的纯 HTTP

与 MCP 服务器相同的三次调用。发起扫描、轮询、读取报告——可用于 CI、CRM 工作流或夜间任务。

1 · 发起扫描
curl -s -X POST https://aeostate.com/api/analyze \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","industry":"family dental clinic","category":"family dental clinic","locale":"en"}'
# → {"mode":"async","jobId":"…"} (poll below) or the finished free summary
2 · 轮询直至完成
curl -s https://aeostate.com/api/scan-jobs/<jobId>
# → {"status":"queued|running|completed|failed","stage":"crawling|scoring|completed","reportId":"…"}
3 · 读取报告
curl -s https://aeostate.com/api/reports/<reportId>
# → 402 + the free summary (score, grade, confidence, section teasers)

匿名扫描遵循站点的免费评分规则（速率限制；若免费评分需要邮箱验证，评分链接会通过邮件发送）。使用密钥时则以您的账户运行：不设门槛、按密钥限流，并可访问您的付费报告。

AI 代理如何找到 AeoState

除了 MCP 服务器，AeoState 还发布机器可读的描述，让 AI 代理和代理注册表能够自行发现它。下面每个地址都返回任何网站均可读取的 JSON。

MCP 服务器卡片
https://aeostate.com/.well-known/mcp/server-card.json
AI 目录（ARD）
https://aeostate.com/.well-known/ai-catalog.json
API 目录（RFC 9727）
https://aeostate.com/.well-known/api-catalog

AI 代理技能（Agent Skills）

支持 Agent Skills 的 AI 代理可以从此索引加载 AeoState 发布的技能。该技能说明如何通过 MCP 服务器或 HTTP API 运行免费的 AI 可见性检查，以及如何读取结果。每个技能都附有 SHA-256 摘要，便于代理校验所下载的内容。

Agent Skills 索引
https://aeostate.com/.well-known/agent-skills/index.json

以 markdown 获取页面

请求任何公开页面时带上请求头 Accept: text/markdown，即可获得该页面的 markdown 文本而不是 HTML，开头附有标题、地址和语言。浏览器仍然获得普通页面。

示例
curl -H "Accept: text/markdown" https://aeostate.com/zh/pricing

浏览器中的工具（WebMCP）

在支持 WebMCP 的浏览器中，在本网站上工作的 AI 代理可以打开页面、查看当前价格、查询正在进行的扫描，并填写免费评分表单。表单仍由访问者确认并提交。WebMCP 仍处于实验阶段，仅部分浏览器版本提供；在其他浏览器中一切照旧。

免费评分与 Advanced 报告

无需账户

免费评分——每个工具、每位访客

  • 您的整体可见度评分、等级以及我们的置信度
  • 哪些 AI 爬虫可以或无法访问您的网站
  • 阻碍您可见度的首要问题

获取个人 API 密钥

登录（或创建免费账户），打开“账户 → API 访问”，创建密钥并粘贴到上方片段中。密钥仅作用于扫描和您购买的报告——绝不涉及您的账户、账单或他人的报告。

获取密钥
MCP 与 API——在 Claude、智能体和流水线中评估 AI 可见性 — AeoState