API & serveur MCP

Snorklee met vos données à disposition de vos autres outils en lecture seule : scripts, tableaux de bord (Google Looker Studio, Excel…) et assistants IA (Claude, Cursor et tout client MCP). Vos outils lisent vos chiffres, ils ne changent rien. 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, et actif pendant l'essai gratuit de 14 jours.

#Créer une clé

Dans Intégration → API & MCP : donnez un nom à la clé (l'outil qui va s'en servir), cliquez Créer une clé, puis copiez-la tout de suite — elle ne s'affichera plus jamais ; de notre côté, nous n'en gardons qu'une empreinte, pas la clé elle-même. Une clé se révoque en un clic, avec effet immédiat ; vous pouvez en avoir 10 actives.

Ce qu'une clé permet : lire vos sites et leurs statistiques — KPIs, pages principales, funnel Trafic IA et présence IA. Ce qu'elle ne permet pas : modifier quoi que ce soit, ni lire les données d'un site qui ne vous appartient pas.

#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, dans une enveloppe { data, meta }. range vaut 7d, 28d ou 90d (défaut 28d) ; un paramètre optionnel tz fixe le fuseau horaire (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 : vous posez votre question en langage courant, l'assistant va chercher la réponse dans vos chiffres. 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 récupérer un id de site, puis passez-le en site_id avec un range optionnel.

#Reporting

Pour un rapport sans écrire une ligne de code : chaque carte du tableau de bord 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, dans l'Union européenne, sans aucun SDK ni service tiers : vos données ne passent par aucun intermédiaire.