AISeeWhy API 与 MCP 服务器

向审计端点发送一次带 URL 的 POST,即可获得 JSON 报告:0–100 的评分,以及包含优先级、证据和可直接粘贴的修复方案的各项发现,支持 30 种语言。AI 智能体连接到 MCP 端点并调用 audit_url。没有 Pro 或试用密钥时只能看到预览。

POST https://api.aiseewhy.com/v1/audit · https://api.aiseewhy.com/mcp

如何调用 API?

curl -s https://api.aiseewhy.com/v1/audit \
  -H 'content-type: application/json' \
  -H 'x-api-key: asw_…' \
  -d '{"url": "https://example.com/pricing", "language": "zh-Hans"}'

字段:url(必填;缺少时自动补上 https://)、language(报告语言代码,默认 en)、bots(可选的爬虫名称列表)、markdown(附加 Markdown 报告)。在 x-api-key 请求头中发送密钥。站点地图批量审计使用 POST /v1/sitemap,需要密钥。 OpenAPI 描述.

如何通过 MCP 连接 AI 智能体?

使用下方的 URL 添加远程 MCP 服务器(streamable HTTP),并在 x-api-key 请求头中发送密钥。工具:audit_url、audit_sitemap(最多 10 个页面)和 explain_finding。 Model Context Protocol 文档.

{
  "mcpServers": {
    "aiseewhy": { "type": "http", "url": "https://api.aiseewhy.com/mcp",
                  "headers": { "x-api-key": "asw_…" } }
  }
}

一条发现是什么样的?

{
  "id": "access.blocked", "priority": "P1", "bot": "OAI-SearchBot", "bot_class": "search",
  "evidence": { "status": 403, "control_status": 200, "waf": "cloudflare" },
  "fixes": [ { "kind": "cloudflare", "body": "…" } ]
}

优先级:P1 表示 AI 回答无法读取或引用该页面,P2 表示重要,P3 表示锦上添花或属于策略选择,例如屏蔽训练爬虫。robots.txt 按 RFC 9309 的定义解析。 RFC 9309.

有哪些限制?

访问方式限制
无密钥、无账户预览(第一条发现),每个网络每天 1 次检测
Pro 或 7 天试用(网站)完整报告,每天 30 次检测,历史记录
Pro 或试用 API 密钥(API 和 MCP)完整报告,每天 100 次审计,站点地图批量最多 50 个 URL
按站点地图批量审计每次运行最多 5,000 个 URL,按已审计的 URL 付费

发往私有或内部地址的请求会被拒绝。无法审计的页面会以 fetch.error 或 fetch.status 发现的形式报告。