API y servidor MCP

Snorklee expone tus datos en solo lectura a tus otras herramientas: scripts, cuadros de mando (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.

#Crear una clave

En Integración → API & MCP: dale 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 más; nosotros 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, tu visibilidad IA, tus citas, tus preguntas seguidas y tu centro de acciones. 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}/geo/visibility
GET /api/v1/sites/{id}/geo/citations?limit=50
GET /api/v1/sites/{id}/geo/questions
GET /api/v1/sites/{id}/actions

Las respuestas son JSON, con envoltura { data, meta }. Límite: 300 peticiones por hora y por clave.

#El servidor MCP

El Model Context Protocol permite a un asistente de IA consultar tus datos de Snorklee en tu nombre (« ¿cuál es mi tasa de citación este mes? »). 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 entonces de 5 herramientas: list_sites, get_ai_visibility, list_citations, list_questions, list_actions — todas en solo lectura.

#Reporting

Para un informe sin código: cada tarjeta del dashboard tiene un botón de exportación CSV, y la exportación global (botón en la parte superior de la pestaña Analytics) descarga un ZIP completo, categoría por categoría — incluida la visibilidad IA (08-ai-visibility/). 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 transitan por ningún intermediario.