API та сервер MCP AISeeWhy

Надішліть один POST з URL на кінцеву точку аудиту й отримайте звіт JSON: оцінку від 0 до 100, знахідки з пріоритетом, доказами та готовими до вставлення виправленнями, будь-якою з 30 мов. ШІ-агенти підключаються до кінцевої точки 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": "uk"}'

Поля: url (обов'язкове; https:// додається, якщо його немає), language (код мови звіту, типово en), bots (необов'язковий список назв краулерів), markdown (додати звіт у Markdown). Передавайте ключ у заголовку x-api-key. Пакети за sitemap використовують POST /v1/sitemap і потребують ключа. Опис OpenAPI.

Як підключити ШІ-агента через MCP?

Додайте віддалений сервер MCP з наведеним нижче URL (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 означає, що відповіді ШІ не можуть прочитати чи процитувати сторінку, P2 важливо, P3 бажано або вибір політики, наприклад блокування краулера для навчання. robots.txt читається за визначенням у RFC 9309. RFC 9309.

Які є ліміти?

Запити на приватні чи внутрішні адреси відхиляються. Сторінки, які не вдалося перевірити, повідомляються зі знахідкою fetch.error або fetch.status.