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 — nie über Ihr Passwort. Der API- & MCP-Zugang ist im Abonnement Snorklee One enthalten.

#Einen Schlüssel erstellen

Unter Integration → API & MCP: Geben Sie dem Schlüssel einen Namen (das Tool, das ihn verwendet), klicken Sie auf 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 und deren Analytics lesen — KPIs, Top-Seiten, KI-Traffic-Funnel und KI-Präsenz. Was er nicht kann: irgendetwas ä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}/kpis?range=28d
GET /api/v1/sites/{id}/top-pages?range=28d&limit=20
GET /api/v1/sites/{id}/ai-funnel?range=28d
GET /api/v1/sites/{id}/ai-presence?range=28d

Die Antworten sind JSON im { data, meta }-Umschlag. range ist 7d, 28d oder 90d (Standard 28d); ein optionales tz setzt die Zeitzone (IANA-Name, Standard Europe/Paris). Limit: 1 000 Anfragen pro Stunde und Schlüssel.

#Der MCP-Server

Das Model Context Protocol erlaubt einem KI-Assistenten, Ihre Snorklee-Daten in Ihrem Namen abzufragen. Fügen Sie diese Konfiguration in Claude, Cursor oder einen beliebigen 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 erhält fünf schreibgeschützte Tools: list_sites, dann get_kpis, get_top_pages, get_ai_funnel und get_ai_presence. Rufen Sie zuerst list_sites für eine Site-id auf und übergeben Sie sie als site_id mit einem optionalen range.

#Reporting

Für einen Bericht ohne Code: Jede Dashboard-Karte hat einen CSV-Export-Button, und der globale Export (Button oben im Analytics-Tab) lädt ein vollständiges ZIP herunter, Kategorie für Kategorie. Diese Dateien lassen sich unverändert in Google Looker Studio, Excel oder jede Tabellenkalkulation importieren.

#Souveränität

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