AISeeWhy の API と MCP サーバー
監査エンドポイントに URL を POST すると、0〜100 のスコアと、優先度・証拠・修正案付きの指摘を含む JSON レポートを 30 言語で受け取れます。AI エージェントは MCP エンドポイントで audit_url を呼び出します。キーがない場合はプレビューのみです。
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": "ja"}'
フィールド: url(必須。https:// がない場合は自動で付加)、language(レポートの言語コード。既定は en)、bots(クローラー名の任意リスト)、markdown(Markdown レポートを追加)。キーは x-api-key ヘッダーで送信します。サイトマップの一括監査は POST /v1/sitemap を使用し、キーが必要です。 OpenAPI の説明.
AI エージェントを MCP で接続するには?
下の 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日1回チェック |
| Pro または7日間トライアル(ウェブサイト) | 完全なレポート、1 日 30 回のチェック、履歴 |
| Pro またはトライアルの API キー(API と MCP) | 完全なレポート、1 日 100 回の監査、最大 50 URL のサイトマップ一括監査 |
| サイトマップによる一括監査 | 1 回の実行で最大 5,000 URL、監査した URL ごとの従量課金 |
プライベートアドレスや内部アドレスへのリクエストは拒否されます。監査できないページは fetch.error または fetch.status の指摘として報告されます。