Entwickler

GEO Tool API

Zwei lesende Endpunkte, keine Authentifizierung, kein Schlüssel, keine Anmeldung. Die Spezifikation liegt maschinenlesbar unter /openapi.json und beschreibt jeden Parameter und jedes Antwortfeld.

OpenAPI 3.1 ansehenv1.0.0 · OpenAPI 3.1.0

Endpunkte

GET/api/v1/blog/posts

Blogartikel einer Sprache auflisten, seitenweise.

operationId: listBlogPosts

curl "https://www.geo-tool.com/api/v1/blog/posts?locale=en&perPage=5"
GET/api/v1/geo-index

Aggregierte Kennzahlen aus allen live-verifizierten Messungen.

operationId: getVisibilityIndex

curl "https://www.geo-tool.com/api/v1/geo-index"

MCP & Agents

Der GEO-Technik-Check steht Agenten in jeder Form zur Verfügung — als gehosteter MCP-Server, lokales npm-Paket, Claude-Code-Plugin und Browser-Erweiterung. Drei read-only Tools: check_ai_readiness (Score 0–100), check_ai_crawlers (robots.txt vs. KI-Crawler), check_citability (Zitierfähigkeit eines Entwurfs).

Gehosteter MCP-Server (Streamable HTTP, ohne Auth, 30 Calls/Stunde):

https://www.geo-tool.com/api/mcp

Lokal und unlimitiert — CLI und MCP-Server per npm:

npx -y geo-tool-check --mcp

Weitere Wege: Official MCP Registry (io.github.shufflethis/geo-tool-check), Claude-Code-Plugin (/plugin marketplace add geo-tool-com/geo-tool-check) und die quelloffene Browser-Erweiterung. github.com/geo-tool-com/geo-tool-check · geo-tool-extension

Authentifizierung

Keine. Beide Endpunkte sind öffentlich und lesend, es gibt keine Schlüssel und keine Kontingente pro Konto. Die Antworten werden am Edge zwischengespeichert: Blogartikel 24 Stunden, der Sichtbarkeits-Index eine Stunde. Wer häufiger abfragt, bekommt denselben Cache-Treffer. Alle Antworten tragen RateLimit-Header (RateLimit-Limit, RateLimit-Policy; der MCP-Endpunkt zusätzlich Remaining/Reset und Retry-After), damit Agenten sich selbst drosseln können.

Versionierung & Deprecation

Stabile Endpunkte liegen unter dem Major-Version-Pfad /api/v1. Breaking Changes erscheinen nur unter einem neuen Major-Pfad (/api/v2); /api/v1 läuft dann mindestens 6 Monate weiter. Abkündigungen signalisieren wir per Deprecation- und Sunset-Header (RFC 9745) am betroffenen Endpunkt und kündigen sie auf dieser Seite an. Die unversionierten Pfade bleiben als Alias erhalten.

Fehlerformat

Fehler kommen immer als JSON mit denselben drei Feldern: error als lesbare Meldung, code als stabiler Bezeichner und hint mit dem, was zu ändern ist.

{
  "error": "Visibility index temporarily unavailable",
  "code": "upstream_unavailable",
  "hint": "Retry later."
}

Was nicht Teil der API ist

Die Website-Analyse ist bewusst nicht dokumentiert und nicht für den programmatischen Zugriff gedacht. Sie verbraucht pro Aufruf echte Engine- und Scraper-Zeit. Wer eine Seite prüfen will, nutzt den kostenlosen Check oder die Browser-Erweiterung — die rechnet denselben Score im Tab des Nutzers und kostet nichts.

Kostenlosen Check öffnenBrowser-Erweiterung