API y MCP

Crea una clave en Desarrolladores → Claves de API. Sólo se enseña una vez. Alcances: Lectura (todos los GET) y Escritura (crear artículos y enviarlos a tu CMS). La clave actúa con el rol de quien la creó, recortado por su alcance; si esa persona sale del espacio, la clave deja de valer.

Límites por clave: 120 peticiones por minuto y 10.000 al día (429 con Retry-After).

curl https://get-citable.com/api/v1/sites \
  -H "Authorization: Bearer $CITABLE_API_KEY"

• Webs, con sus últimas tasas de mención y de cita (cada una con su margen del 90 %).
• Visibilidad por pregunta e IA, huecos, lo que respondió cada IA y las fuentes que cita.
• Acciones por prioridad, artículos (markdown, HTML, fuentes, FAQ) y su efecto medido.
• Crear un artículo a partir de una pregunta o un hueco y enviarlo a tu CMS (como borrador salvo que tengas la publicación automática).
• La última auditoría, las visitas desde IA y el informe para clientes en JSON.

Especificación completa (OpenAPI 3.1): /api/v1/openapi.json.

En Desarrolladores, añade una URL https pública y elige eventos: measurement.completed, gap.opened, article.ready, article.published, article.failed, audit.completed, digest.sent y lead.created. Cada entrega va firmada (Citable-Signature) con un secreto que se enseña una vez; responde 2xx en menos de 10 segundos. Las entregas fallidas se reintentan durante unas 33 horas.

Para recibir los propios artículos en tu blog, usa el webhook de publicación: Next.js y webs a medida.

Pregunta a tu asistente de IA por tu visibilidad en la IA. El servidor MCP de Citable es de sólo lectura: no puede cambiar nada de tu cuenta. Usa una clave de API con el alcance Lectura como cabecera Authorization. Comparte los límites de la clave con la API.

Claude Code: ejecuta una vez en tu terminal:

claude mcp add --transport http citable https://get-citable.com/api/mcp \
  --header "Authorization: Bearer cit_live_…"

Cursor, VS Code, Windsurf y otros clientes que aceptan cabeceras: añade la URL del servidor y la cabecera a la configuración MCP del cliente. La configuración exacta de tu cuenta está en la página Desarrolladores.

Los conectores personalizados de ChatGPT y claude.ai inician sesión con OAuth, que Citable aún no ofrece. Las respuestas escritas por otros asistentes de IA llegan a tu cliente marcadas como texto no confiable.