AIVIS para desarrolladores

Autenticación

Cada solicitud debe autenticarse con una API key en el header Authorization: Bearer aivis_live_.... La clave concede acceso a nivel de organización (puede leer/iniciar análisis en cualquier sitio de la organización).

Crea tu primera API key desde el panel

API REST v1

curl -X POST https://aivis.dev/api/v1/scan \
  -H "Authorization: Bearer aivis_live_..." \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

{
  "domain": "example.com",
  "score": 82,
  "letter": "B",
  "cached": false
}

curl https://aivis.dev/api/v1/report/example.com \
  -H "Authorization: Bearer aivis_live_..."

{
  "domain": "example.com",
  "score": 82,
  "letter": "B",
  "pagesCrawled": 12,
  "crawledAt": "2026-07-04T10:00:00.000Z",
  "sector": "saas",
  "checks": [
    { "id": "robots-ai-bots", "label": "AI bot access", "status": "pass", "score": 100, "evidence": ["..."], "fixHint": null }
  ]
}

<a href="https://aivis.dev/report/example.com">
  <img src="https://aivis.dev/api/v1/badge/example.com" alt="AIVIS AI Visibility Score" />
</a>

Todos los endpoints responden 401 con una clave ausente/no válida y 403 si la organización no está en un plan Business o Agency.

Servidor MCP

AIVIS también está disponible como servidor MCP (Model Context Protocol): un asistente de IA compatible puede ejecutar análisis y leer informes directamente, sin pasar por un navegador. Endpoint: POST https://aivis.dev/api/mcp, JSON-RPC 2.0, misma autenticación Bearer que la API REST.

• scan_domain — inicia (o recupera de la caché) un análisis completo
• get_report — lee el último informe guardado, sin iniciar un nuevo análisis
• check_ai_access — comprobación rápida (solo robots.txt) de qué bots de IA están permitidos o bloqueados

Ejemplo de configuración para un cliente MCP que admite headers personalizados (por ejemplo, Claude Desktop):

{
  "mcpServers": {
    "aivis": {
      "url": "https://aivis.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer aivis_live_..."
      }
    }
  }
}