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.

#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, votre visibilité IA, vos citations, vos questions suivies et votre centre d'actions. 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}/geo/visibility
GET /api/v1/sites/{id}/geo/citations?limit=50
GET /api/v1/sites/{id}/geo/questions
GET /api/v1/sites/{id}/actions

Les réponses sont en JSON, enveloppe { data, meta }. Limite : 300 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 (« quel est mon taux de citation ce mois-ci ? »). 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 alors de 5 outils : list_sites, get_ai_visibility, list_citations, list_questions, list_actions — tous en lecture seule.

#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 — y compris la visibilité IA (08-ai-visibility/). 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.