API & MCP-Server

Snorklee stellt Ihre Daten Ihren anderen Tools schreibgeschützt zur Verfügung: Skripten, Dashboards (Google Looker Studio, Excel…) und KI-Assistenten (Claude, Cursor und jedem MCP-Client). Ihre Tools lesen Ihre Zahlen, sie ändern nichts. Alles läuft über einen persönlichen API-Schlüssel — nie über Ihr Passwort. Der API- & MCP-Zugang ist im Abonnement Snorklee One enthalten, und während der kostenlosen 14-Tage-Testphase aktiv.

#Einen Schlüssel erstellen

Unter Einstellungen › Installation, Bereich 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, nicht der Schlüssel selbst. 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 Statistiken lesen — KPIs, Top-Seiten, KI-Traffic (Robot-Zugriffe und von einer KI geschickte Besucher) 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: Sie stellen Ihre Frage in normaler Sprache, und der Assistent holt die Antwort aus Ihren Zahlen. 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 eine einzige Zeile Code: Jede Dashboard-Karte hat einen CSV-Export-Button, und der globale Export (Button oben im Bildschirm Statistiken) 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.