API & MCP-Server

Snorklee stellt Ihre Daten schreibgeschützt Ihren anderen Tools zur Verfügung: Skripten, Dashboards (Google Looker Studio, Excel…) und KI-Assistenten (Claude, Cursor und jedem MCP-Client). Alles läuft über einen persönlichen API-Schlüssel — niemals über Ihr Passwort.

#Einen Schlüssel erstellen

Unter Integration → API & MCP: Geben Sie dem Schlüssel einen Namen (das Tool, das ihn verwenden wird), klicken Sie Schlüssel erstellen und kopieren Sie ihn sofort — er wird nie wieder angezeigt, bei uns bleibt nur sein Fingerabdruck gespeichert. Ein Schlüssel lässt sich mit einem Klick widerrufen, mit sofortiger Wirkung; Sie können 10 aktive Schlüssel haben.

Was ein Schlüssel kann: Ihre Websites, Ihre KI-Sichtbarkeit, Ihre Zitate, Ihre verfolgten Fragen und Ihr Aktionscenter lesen. Was er nicht kann: irgendetwas verändern oder Daten einer Website lesen, deren Eigentümer Sie nicht sind.

#Die REST-API

Fügen Sie Ihren Anfragen den Header Authorization: Bearer snk_… hinzu:

GET /api/v1/sites
GET /api/v1/sites/{id}/geo/visibility
GET /api/v1/sites/{id}/geo/citations?limit=50
GET /api/v1/sites/{id}/geo/questions
GET /api/v1/sites/{id}/actions

Die Antworten sind JSON, im Umschlag { data, meta }. Limit: 300 Anfragen pro Stunde und Schlüssel.

#Der MCP-Server

Das Model Context Protocol erlaubt einem KI-Assistenten, Ihre Snorklee-Daten in Ihrem Namen abzufragen („wie hoch ist meine Zitierquote diesen Monat?“). Fügen Sie diese Konfiguration in Claude, Cursor oder jeden MCP-Client ein und ersetzen Sie snk_… durch Ihren Schlüssel:

{
  "mcpServers": {
    "snorklee": {
      "type": "http",
      "url": "https://snorklee.com/mcp",
      "headers": { "Authorization": "Bearer snk_…" }
    }
  }
}

Der Assistent verfügt dann über 5 Tools: list_sites, get_ai_visibility, list_citations, list_questions, list_actions — alle schreibgeschützt.

#Reporting

Für einen Bericht ohne Code: Jede Karte des Dashboards hat einen CSV-Export-Button, und der Gesamtexport (Button oben im Analytics-Tab) lädt ein vollständiges ZIP herunter, Kategorie für Kategorie — einschließlich der KI-Sichtbarkeit (08-ai-visibility/). Diese Dateien lassen sich unverändert in Google Looker Studio, Excel oder jede Tabellenkalkulation importieren.

#Souveränität

Der MCP-Server und die API werden von Snorklee entwickelt und gehostet, in der Europäischen Union, ohne SDK oder Drittanbieterdienst: Ihre Daten laufen über keinen Zwischenhändler.