API & serveur MCP

Snorklee expose vos données en lecture seule à vos autres outils : scripts, tableaux de bord (Google Looker Studio, Excel…), et assistants IA (Claude, Cursor et tout client MCP). Tout passe par une clé API personnelle — jamais par votre mot de passe. L'accès API & MCP est inclus dans l'abonnement Snorklee One.

#Créer une clé

Dans Intégration → API & MCP : donnez un nom à la clé (l'outil qui l'utilisera), cliquez Créer une clé, et copiez-la immédiatement — elle ne sera plus jamais affichée, seule son empreinte est conservée chez nous. Une clé se révoque en un clic, avec effet immédiat ; vous pouvez en avoir 10 actives.

Ce qu'une clé peut faire : lire vos sites et leurs analytics — KPIs, pages principales, funnel Trafic IA et présence IA. Ce qu'elle ne peut pas faire : modifier quoi que ce soit, ni lire les données d'un site dont vous n'êtes pas propriétaire.

#L'API REST

Ajoutez l'en-tête Authorization: Bearer snk_… à vos requêtes :

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

Les réponses sont en JSON, enveloppe { data, meta }. range vaut 7d, 28d ou 90d (défaut 28d) ; un paramètre optionnel tz fixe le fuseau (nom IANA, défaut Europe/Paris). Limite : 1 000 requêtes par heure et par clé.

#Le serveur MCP

Le Model Context Protocol permet à un assistant IA d'interroger vos données Snorklee en votre nom. Collez cette configuration dans Claude, Cursor ou tout client MCP, en remplaçant snk_… par votre clé :

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

L'assistant dispose de cinq outils en lecture seule : list_sites, puis get_kpis, get_top_pages, get_ai_funnel et get_ai_presence. Appelez d'abord list_sites pour obtenir un id de site, puis passez-le en site_id avec un range optionnel.

#Reporting

Pour un rapport sans code : chaque carte du dashboard a un bouton d'export CSV, et l'export global (bouton en haut de l'onglet Analytics) télécharge un ZIP complet, catégorie par catégorie. Ces fichiers s'importent tels quels dans Google Looker Studio, Excel ou n'importe quel tableur.

#Souveraineté

Le serveur MCP et l'API sont développés et hébergés par Snorklee, en Union européenne, sans SDK ni service tiers : vos données ne transitent par aucun intermédiaire.