API y servidor MCP de AISeeWhy

Envíe un POST con una URL al endpoint de auditoría y reciba un informe JSON: una puntuación de 0 a 100 y hallazgos con prioridad, evidencia y correcciones listas para pegar, en 30 idiomas. Los agentes de IA se conectan al endpoint MCP y llaman a audit_url. Sin clave Pro o de prueba, solo verá una vista previa.

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

¿Cómo llamo a la 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": "es"}'

Campos: url (obligatorio; se añade https:// si falta), language (código de idioma del informe, por defecto en), bots (lista opcional de nombres de rastreadores), markdown (añade un informe en Markdown). Envíe su clave en la cabecera x-api-key. Los lotes por sitemap usan POST /v1/sitemap y requieren una clave. Descripción OpenAPI.

¿Cómo conecto un agente de IA mediante MCP?

Añada un servidor MCP remoto con la URL de abajo (HTTP streamable) y envíe su clave en la cabecera x-api-key. Herramientas: audit_url, audit_sitemap (hasta 10 páginas) y explain_finding. Documentación de Model Context Protocol.

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

¿Cómo es un hallazgo?

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

Prioridades: P1 significa que las respuestas de IA no pueden leer ni citar la página, P2 es importante, P3 es deseable o una decisión de política, por ejemplo bloquear un rastreador de entrenamiento. robots.txt se lee tal como define la RFC 9309. RFC 9309.

¿Cuáles son los límites?

Se rechazan las solicitudes a direcciones privadas o internas. Las páginas que no se pueden auditar se notifican con un hallazgo fetch.error o fetch.status.