API y servidor MCP

Snorklee expone tus datos en solo lectura a tus otras herramientas: scripts, paneles (Google Looker Studio, Excel…) y asistentes de IA (Claude, Cursor y cualquier cliente MCP). Todo pasa por una clave API personal — nunca por tu contraseña. El acceso API y MCP está incluido en la suscripción Snorklee One.

#Crear una clave

En Integración → API & MCP: da un nombre a la clave (la herramienta que la usará), haz clic en Crear una clave y cópiala inmediatamente — no volverá a mostrarse nunca; solo conservamos su huella. Una clave se revoca en un clic, con efecto inmediato; puedes tener 10 activas.

Lo que una clave puede hacer: leer tus sitios y su analítica — KPIs, páginas principales, funnel del tráfico IA y presencia IA. Lo que no puede hacer: modificar nada, ni leer los datos de un sitio del que no eres propietario.

#La API REST

Añade la cabecera Authorization: Bearer snk_… a tus peticiones:

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

Las respuestas son JSON, con envoltorio { data, meta }. range es 7d, 28d o 90d (por defecto 28d); un parámetro opcional tz fija la zona horaria (nombre IANA, por defecto Europe/Paris). Límite: 1 000 peticiones por hora y clave.

#El servidor MCP

El Model Context Protocol permite a un asistente de IA consultar tus datos de Snorklee en tu nombre. Pega esta configuración en Claude, Cursor o cualquier cliente MCP, sustituyendo snk_… por tu clave:

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

El asistente dispone de cinco herramientas de solo lectura: list_sites, luego get_kpis, get_top_pages, get_ai_funnel y get_ai_presence. Llama primero a list_sites para obtener un id de sitio y pásalo como site_id con un range opcional.

#Informes

Para un informe sin código: cada tarjeta del panel tiene un botón de exportación CSV, y la exportación global (botón en la parte superior de la pestaña Panel) descarga un ZIP completo, categoría por categoría. Estos archivos se importan tal cual en Google Looker Studio, Excel o cualquier hoja de cálculo.

#Soberanía

El servidor MCP y la API están desarrollados y alojados por Snorklee, en la Unión Europea, sin SDK ni servicios de terceros: tus datos no pasan por ningún intermediario.