API & MCP-server

Snorklee stelt uw gegevens alleen-lezen beschikbaar aan uw andere tools: scripts, dashboards (Google Looker Studio, Excel…) en AI-assistenten (Claude, Cursor en elke MCP-client). Alles verloopt via een persoonlijke API-sleutel — nooit via uw wachtwoord. De API- & MCP-toegang is inbegrepen in het abonnement Snorklee One.

#Een sleutel aanmaken

In Integratie → API & MCP: geef de sleutel een naam (de tool die hem gaat gebruiken), klik op Sleutel aanmaken en kopieer hem meteen — hij wordt nooit meer getoond; alleen zijn vingerafdruk blijft bij ons bewaard. Een sleutel is met één klik te intrekken, met onmiddellijk effect; u kunt er 10 actief hebben.

Wat een sleutel kan: uw sites en hun analytics lezen — KPI's, toppagina's, AI-verkeersfunnel en AI-aanwezigheid. Wat hij niet kan: iets wijzigen, of gegevens lezen van een site waarvan u geen eigenaar bent.

#De REST-API

Voeg de header Authorization: Bearer snk_… toe aan uw verzoeken:

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

De antwoorden zijn JSON, in een { data, meta }-omhulsel. range is 7d, 28d of 90d (standaard 28d); een optionele tz stelt de tijdzone in (IANA-naam, standaard Europe/Paris). Limiet: 1 000 verzoeken per uur per sleutel.

#De MCP-server

Het Model Context Protocol laat een AI-assistent uw Snorklee-gegevens namens u bevragen. Plak deze configuratie in Claude, Cursor of elke MCP-client, en vervang snk_… door uw sleutel:

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

De assistent beschikt over vijf alleen-lezen tools: list_sites, dan get_kpis, get_top_pages, get_ai_funnel en get_ai_presence. Roep eerst list_sites aan voor een site-id en geef die als site_id mee met een optionele range.

#Rapportage

Voor een rapport zonder code: elke dashboardkaart heeft een CSV-export-knop, en de globale export (knop bovenaan het tabblad Dashboard) downloadt een volledige ZIP, categorie per categorie. Deze bestanden importeert u ongewijzigd in Google Looker Studio, Excel of elke spreadsheet.

#Soevereiniteit

De MCP-server en de API worden door Snorklee ontwikkeld en gehost, in de Europese Unie, zonder SDK of externe dienst: uw gegevens passeren geen enkele tussenpersoon.