AIVIS per sviluppatori

Autenticazione

Ogni richiesta va autenticata con una API key nell'header Authorization: Bearer aivis_live_.... La chiave concede accesso a livello di organizzazione (può leggere/avviare scan su qualunque sito dell'organizzazione).

Crea la tua prima API key dalla dashboard

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>

Tutti gli endpoint rispondono 401 con una chiave mancante/non valida e 403 se l'organizzazione non è su un piano Business o Agency.

Server MCP

AIVIS è disponibile anche come server MCP (Model Context Protocol): un assistente AI compatibile può eseguire scan e leggere report direttamente, senza passare da un browser. Endpoint: POST https://aivis.dev/api/mcp, JSON-RPC 2.0, stessa autenticazione Bearer dell'API REST.

• scan_domain — avvia (o recupera dalla cache) uno scan completo
• get_report — legge l'ultimo report salvato, senza avviare un nuovo scan
• check_ai_access — verifica rapida (solo robots.txt) di quali bot AI sono permessi o bloccati

Esempio di configurazione per un client MCP che supporta header personalizzati (es. Claude Desktop):

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