Documentación

Usa Checkmark desde tu asistente de IA

Checkmark expone sus herramientas por MCP (Model Context Protocol), así que puedes pedirle a ChatGPT, Claude, Cursor o cualquier cliente compatible que ejecute chequeos de visibilidad y genere contenido en tu propia cuenta.

Conectar

1. 1.Agrega este servidor MCP en tu cliente: https://checkmark.to/mcp
2. 2.El cliente te llevará a iniciar sesión en Checkmark y te pedirá permiso.
3. 3.Al aceptar, el asistente actúa como tu usuario: solo ve tus marcas y tus reportes.
4. 4.Puedes revocar el acceso volviendo a conectar o cerrando sesión desde Ajustes.

https://checkmark.to/mcp

Herramientas disponibles

Cada herramienta respeta los permisos y los límites de tu plan.

• list_brands

  Las marcas que sigues, con dominio, mercado y competidores.

• create_brand

  Crear una marca nueva para monitorear.

• list_questions

  Las preguntas de compra que Checkmark hace por marca.

• add_questions

  Agregar preguntas de compra (hasta 20 por llamada).

• run_visibility_check

  Ejecutar un chequeo y guardarlo como reporte.

• get_report

  Leer un reporte: score, menciones, competidores y citas.

• generate_content

  Generar bloque de respuesta, FAQ y JSON-LD publicables.

• quick_check

  Chequeo rápido de cualquier dominio, sin crear marca.

Autenticación

Se usa OAuth 2.1 con registro dinámico de clientes: no hay que crear ni pegar claves a mano.

Las peticiones sin sesión válida responden 401 y ninguna herramienta lee datos de otras cuentas.

Límites y chequeos largos

Marcas, preguntas, chequeos mensuales y contenidos generados cuentan contra tu plan, igual que en la app.

run_visibility_check procesa por lotes: si quedan respuestas pendientes devuelve el report_id para continuar en la siguiente llamada.

API web simple

¿Prefieres HTTP? Las mismas funciones están disponibles como API REST con claves, para scripts, automatizaciones (n8n, Zapier, Make) o tu propio backend.

1. 1.Crea una clave en Checkmark, en Ajustes → Claves de API. Cópiala en ese momento: no se vuelve a mostrar.
2. 2.Envíala en cada petición en el encabezado Authorization: Bearer.
3. 3.Inicia el chequeo, llama al endpoint advance hasta que el status sea "done" y luego lee el reporte.
4. 4.Puedes revocar la clave cuando quieras desde Ajustes; las peticiones dejan de funcionar al instante.

curl -X POST https://checkmark.to/api/public/v1/brands \
  -H "Authorization: Bearer ck_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme","domain":"acme.com","market":"Mexico"}'

curl -X POST https://checkmark.to/api/public/v1/brands/<brand_id>/runs -H "Authorization: Bearer ck_..."
curl -X POST https://checkmark.to/api/public/v1/runs/<run_id>/advance -H "Authorization: Bearer ck_..."
curl https://checkmark.to/api/public/v1/runs/<run_id> -H "Authorization: Bearer ck_..."

Endpoints

• GET /me

  Tu plan, estado de suscripción, límites y uso del mes.

• GET/POST /brands

  Listar o crear marcas monitoreadas.

• GET/POST /brands/{brand_id}/questions

  Listar o agregar preguntas de compra de una marca.

• GET/POST /brands/{brand_id}/runs

  Listar reportes de la marca o iniciar un chequeo nuevo.

• GET /runs/{run_id}

  Leer un reporte con score, menciones y citas.

• POST /runs/{run_id}/advance

  Procesar el siguiente paso del chequeo hasta que termine.

• GET/POST /content

  Listar o generar contenido publicable.

• POST /quick-check

  Chequeo rápido de un dominio, sin crear marca.

• GET /openapi.json

  Especificación OpenAPI 3.1 de esta API.

Especificación completa para máquinas (OpenAPI 3.1): https://checkmark.to/api/public/v1/openapi.json