API & MCP-server

Snorklee stelt je gegevens alleen-lezen open voor je 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 je wachtwoord.

#Een sleutel aanmaken

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

Wat een sleutel kan: je sites, je AI-zichtbaarheid, je citaties, je gevolgde vragen en je actiecentrum lezen. Wat hij niet kan: iets wijzigen, of gegevens lezen van een site waarvan je geen eigenaar bent.

#De REST-API

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

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

De antwoorden zijn JSON, met envelop { data, meta }. Limiet: 300 verzoeken per uur per sleutel.

#De MCP-server

Het Model Context Protocol laat een AI-assistent je Snorklee-gegevens namens jou bevragen ("wat is mijn citatiepercentage deze maand?"). Plak deze configuratie in Claude, Cursor of elke MCP-client, en vervang snk_… door je sleutel:

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

De assistent beschikt dan over 5 tools: list_sites, get_ai_visibility, list_citations, list_questions, list_actions — allemaal alleen-lezen.

#Rapportage

Voor een rapport zonder code: elke kaart van het dashboard heeft een CSV-exportknop, en de globale export (knop bovenaan het tabblad Analytics) downloadt een compleet ZIP-bestand, categorie per categorie — inclusief de AI-zichtbaarheid (08-ai-visibility/). Deze bestanden importeer je ongewijzigd in Google Looker Studio, Excel of elke andere spreadsheet.

#Soevereiniteit

De MCP-server en de API zijn ontwikkeld en gehost door Snorklee, in de Europese Unie, zonder SDK of dienst van derden: je gegevens passeren geen enkele tussenpartij.