AIVIS für Entwickler

Authentifizierung

Jede Anfrage muss mit einem API-Schlüssel im Header Authorization: Bearer aivis_live_... authentifiziert werden. Der Schlüssel gewährt Zugriff auf Organisationsebene (kann Scans für jede Website der Organisation lesen/starten).

Erstelle deinen ersten API-Schlüssel im Dashboard

REST-API 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>

Alle Endpunkte antworten mit 401 bei fehlendem/ungültigem Schlüssel und mit 403, wenn die Organisation nicht auf einem Business- oder Agency-Plan ist.

MCP-Server

AIVIS ist auch als MCP-Server (Model Context Protocol) verfügbar: ein kompatibler KI-Assistent kann Scans direkt ausführen und Berichte lesen, ohne einen Browser zu benutzen. Endpunkt: POST https://aivis.dev/api/mcp, JSON-RPC 2.0, gleiche Bearer-Authentifizierung wie die REST-API.

• scan_domain — startet (oder ruft aus dem Cache ab) einen vollständigen Scan
• get_report — liest den zuletzt gespeicherten Bericht, ohne einen neuen Scan zu starten
• check_ai_access — schnelle Prüfung (nur robots.txt), welche KI-Bots erlaubt oder blockiert sind

Beispielkonfiguration für einen MCP-Client, der benutzerdefinierte Header unterstützt (z. B. Claude Desktop):

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