API и сервер MCP AISeeWhy

Отправьте один POST с URL на эндпоинт аудита и получите отчёт в 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": "ru"}'

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

Как подключить AI-агента по 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 означает, что AI-ответы не могут прочитать или процитировать страницу, P2 важно, P3 желательно или вопрос политики, например блокировка краулера для обучения. robots.txt читается по правилам RFC 9309. RFC 9309.

Какие есть лимиты?

Запросы к приватным и внутренним адресам отклоняются. Страницы, которые не удалось проверить, помечаются находкой fetch.error или fetch.status.