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) – sie beschreiben das Kontingent, auf das der Aufruf angerechnet wurde. Eine 429-Antwort enthält zusätzlich Retry-After. Aufrufe ohne Schlüssel zählen zum gemeinsamen Kontingent der kostenlosen Tools für deinen Internetanschluss; Aufrufe mit Schlüssel zählen zum täglichen api_calls-Kontingent deines Workspace, und jeder Schlüssel kann ein eigenes, niedrigeres Tageslimit haben. Ein Aufruf ohne Ergebnis – weil die Website nicht erreichbar war oder ihr Bot-Schutz geantwortet hat – wird gar nicht gezählt.

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 und teilen sich das Kontingent ohne Schlüssel von 3 Prüfungen pro Tag und Internetanschluss. Für get_site_audit_summary muss dein Client den API-Schlüssel im Header Authorization: Bearer senden; das erhöht zugleich dieses Tageskontingent. 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. Ein Aufruf mit Schlüssel zählt zum selben täglichen api_calls-Kontingent wie die REST-API; ohne Schlüssel zählt er zum gemeinsamen Kontingent der kostenlosen Tools.

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 und nutzt das Kontingent ohne Schlüssel; ein optionaler Schlüssel erhöht dieses Limit und zeigt 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