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-Hant"}'

欄位: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 發現的形式回報。