API & server MCP

Snorklee espone i tuoi dati in sola lettura agli altri tuoi 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.

#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 verrà mai più mostrata, da noi ne viene conservata solo l'impronta. Una chiave si revoca in un clic, con effetto immediato; puoi averne 10 attive.

Cosa può fare una chiave: leggere i tuoi siti, la tua visibilità IA, le tue citazioni, le tue domande monitorate e il tuo centro azioni. 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}/geo/visibility
GET /api/v1/sites/{id}/geo/citations?limit=50
GET /api/v1/sites/{id}/geo/questions
GET /api/v1/sites/{id}/actions

Le risposte sono in JSON, con involucro { data, meta }. Limite: 300 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 (« qual è il mio tasso di citazione questo mese? »). 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 così di 5 strumenti: list_sites, get_ai_visibility, list_citations, list_questions, list_actions — tutti in sola lettura.

#Reporting

Per un report senza codice: ogni card del dashboard ha un pulsante di esportazione CSV, e l'esportazione globale (pulsante in cima alla scheda Analytics) scarica uno ZIP completo, categoria per categoria — inclusa la visibilità IA (08-ai-visibility/). 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 per alcun intermediario.