Citevana API und MCP-Server

REST-API

Alle Antworten sind JSON. Erfolgreiche Antworten enthalten "ok": true. Die kostenlosen Tools liefern eine verständliche Zusammenfassung und eine nach Wichtigkeit sortierte To-do-Liste mit Zeitschätzungen.

Beispielanfrage

curl -s https://citevana.com/api/v1/tools/ai-crawlers \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

curl -s https://citevana.com/api/v1/sites \
  -H "Authorization: Bearer $CITEVANA_API_KEY"

Fehler

Alle Fehler haben dieselbe JSON-Struktur (siehe unten). Fehlercodes sind unter anderem invalid_request, invalid_url, blocked_host, fetch_failed, unauthorized, insufficient_scope, not_found, rate_limited und quota_exceeded.

{
  "ok": false,
  "error": {
    "code": "quota_exceeded",
    "message": "Daily api_calls quota reached."
  },
  "requestId": "req_…"
}

Limits und Header

Jede gezählte Antwort enthält X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset (Unix-Sekunden). Eine 429-Antwort enthält zusätzlich Retry-After. Aufrufe mit Schlüssel zählen zum täglichen api_calls-Kontingent deines Workspace; jeder Schlüssel kann ein eigenes, niedrigeres Tageslimit haben.

Browser können die kostenlosen Tool-Endpunkte ohne Schlüssel von jeder Website aus aufrufen. Endpunkte, die einen Schlüssel brauchen, erlauben keine Cross-Origin-Browseranfragen – rufe sie von deinem Server auf.

Hänge ?locale=es, pt-BR, de, fr, ja, id, hi, tr, vi oder ar an einen Tool-Endpunkt an, um die Zusammenfassung in dieser Sprache zu erhalten.

Quelle, geprüft am 16. September 2026: https://spec.openapis.org/oas/v3.1.1.html

MCP-Server

Verbinde einen beliebigen MCP-Client, der Remote-Server unterstützt, mit https://citevana.com/api/mcp. Er nutzt den Streamable-HTTP-Transport, antwortet mit JSON und führt keine Sessions.

• check_ai_crawlers — Welche KI-Such-, Assistenten- und Trainings-Crawler eine Website zulässt. Kostenlos.
• audit_page — On-Page-SEO- und KI-Bereitschafts-Audit einer URL. Kostenlos.
• generate_llms_txt — Erstellt eine llms.txt aus Website-Name, Zusammenfassung und Links. Kostenlos; es wird nichts abgerufen.
• get_site_audit_summary — Letztes Audit einer deiner Websites. Benötigt einen API-Schlüssel mit read:audits.

Der Server unterstützt die Protokollrevision 2026-07-28 (Metadaten pro Anfrage und server/discover). Außerdem akzeptiert er den initialize-Handshake der Revisionen 2025-11-25, 2025-06-18 und 2025-03-26.

Die drei kostenlosen Tools funktionieren ohne Authentifizierung. Für get_site_audit_summary muss dein Client den API-Schlüssel im Header Authorization: Bearer senden. Citevana bietet noch keine OAuth-Anmeldung für MCP an.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_ai_crawlers",
    "arguments": {
      "url": "https://example.com"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

Quelle, geprüft am 16. September 2026: https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http

Andere MCP-Clients und eigene Agenten

Wenn dein Client HTTP-Header für einen Remote-Server erlaubt, setze Authorization: Bearer gefolgt von deinem Schlüssel, um get_site_audit_summary freizuschalten. Jeder Aufruf zählt zum selben täglichen api_calls-Kontingent wie die REST-API.

Chrome-Erweiterung

Die Chrome-Erweiterung von Citevana führt über diese API die KI-Crawler-Prüfung und das Seiten-Audit für den geöffneten Tab aus. Sie braucht kein Konto; mit einem optionalen Schlüssel siehst du die Audits deiner eigenen Websites. Sie wird gerade für den Chrome Web Store vorbereitet.

Sie fragt nur die Berechtigungen activeTab und storage sowie den Zugriff auf die Citevana-API an. Die Seitenadresse wird nur gesendet, wenn du auf eine Prüfung klickst – und nie mit Query-String.

Quelle, geprüft am 16. September 2026: https://developer.chrome.com/docs/extensions/develop/concepts/activeTab

Sicherheit und Datenschutz

• Alle Tools lesen nur. An deiner Website wird nie etwas geändert.
• Text aus abgerufenen Seiten wird als nicht vertrauenswürdige Daten markiert, damit KI-Assistenten darin enthaltenen Anweisungen nie folgen.
• Wir rufen nur öffentliche Seiten als CitevanaBot ab und blockieren private und reservierte Netzwerkadressen.
• Wir speichern nur einen SHA-256-Hash jedes API-Schlüssels. Der Schlüssel wird einmal angezeigt und kann jederzeit widerrufen werden. Erstellen und Widerrufen von Schlüsseln wird im Audit-Log festgehalten.

CitevanaBot

Häufige Fragen

Quellen

• https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http
• https://modelcontextprotocol.io/specification/2026-07-28/basic/versioning
• https://developers.openai.com/apps-sdk/deploy/connect-chatgpt
• https://developers.openai.com/apps-sdk/build/auth
• https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
• https://spec.openapis.org/oas/v3.1.1.html
• https://developer.chrome.com/docs/extensions/develop/concepts/activeTab
• https://developer.chrome.com/docs/webstore/program-policies/policies