API & server MCP

Snorklee espone i tuoi dati in sola lettura ai tuoi altri strumenti: script, dashboard (Google Looker Studio, Excel…) e assistenti IA (Claude, Cursor e qualsiasi client MCP). Tutto passa da una chiave API personale — mai dalla tua password. L'accesso API & MCP è incluso nell'abbonamento Snorklee One.

#Creare una chiave

In Integrazione → API & MCP: dai un nome alla chiave (lo strumento che la userà), clicca Crea una chiave e copiala subito — non sarà mai più mostrata; da noi resta solo la sua impronta. Una chiave si revoca in un clic, con effetto immediato; puoi averne 10 attive.

Cosa può fare una chiave: leggere i tuoi siti e le loro analytics — KPI, pagine principali, funnel del traffico IA e presenza IA. Cosa non può fare: modificare alcunché, né leggere i dati di un sito di cui non sei proprietario.

#L'API REST

Aggiungi l'header Authorization: Bearer snk_… alle tue richieste:

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

Le risposte sono in JSON, involucro { data, meta }. range vale 7d, 28d o 90d (predefinito 28d); un parametro opzionale tz imposta il fuso (nome IANA, predefinito Europe/Paris). Limite: 1 000 richieste all'ora per chiave.

#Il server MCP

Il Model Context Protocol permette a un assistente IA di interrogare i tuoi dati Snorklee per conto tuo. Incolla questa configurazione in Claude, Cursor o qualsiasi client MCP, sostituendo snk_… con la tua chiave:

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

L'assistente dispone di cinque strumenti in sola lettura: list_sites, poi get_kpis, get_top_pages, get_ai_funnel e get_ai_presence. Chiama prima list_sites per ottenere un id sito, poi passalo come site_id con un range opzionale.

#Reporting

Per un report senza codice: ogni card della dashboard ha un pulsante di export CSV, e l'export globale (pulsante in cima alla scheda Dashboard) scarica uno ZIP completo, categoria per categoria. Questi file si importano così come sono in Google Looker Studio, Excel o qualsiasi foglio di calcolo.

#Sovranità

Il server MCP e l'API sono sviluppati e ospitati da Snorklee, nell'Unione europea, senza SDK né servizi terzi: i tuoi dati non passano da alcun intermediario.