Presentación de la API de AIclicks y MCP (junio de 2026)

Presentación de la API de AIclicks y MCP (junio de 2026)

Presentación de la API de AIclicks y MCP (junio de 2026)

Escrito por:

Fundador @ aiclicks.io

Revisado por:

Matas Kibildis

Director de Crecimiento @ aiclicks.io

Última actualización:

Verificado por expertos

No headings found on page

Llegue a millones de consumidores que están usando IA para descubrir nuevos productos y marcas

Llegue a millones de consumidores que están usando IA para descubrir nuevos productos y marcas

¿Recuerdas la API y el servidor MCP que dijimos que llegarían pronto? 

Por fin ya están disponibles. 🎉

Ambos te ofrecen acceso de solo lectura a todo lo que ejecuta el panel de control: visibilidad de marca, menciones, citas, los prompts que rastreas y las consultas de distribución (fan-out) que los LLM ejecutan realmente para responderte. 

Son dos formas de acceder a los mismos datos.

  • La API es para construir. Extrae tus datos a un almacén de datos, una herramienta de BI, un informe programado o tu propio script.

  • El MCP es para preguntar. Conecta Claude, Cursor o cualquier asistente de IA y pregunta sobre tu visibilidad en inglés sencillo, sin código.

Usa el que mejor se adapte a tu forma de trabajar, o ambos. 

Comparten la misma clave ak_live_, disponible en los planes Pro, Business y Enterprise, y la configuración de cualquiera de los dos lleva un par de minutos. Esto es lo que contienen los datos, y luego cómo activar cada uno.

Lo que obtienes, de cualquier forma

Todo está construido en torno a una idea: un dominio, los prompts que rastreas para él y cómo responden los motores de IA. 

La API lo expone como ocho endpoints de lectura; el MCP envuelve los mismos datos como herramientas que tu asistente puede invocar. Aquí tienes el conjunto completo.

Endpoint 

Qué devuelve

Para qué usarlo

/validate

Estado de la clave, equipo, alcance, límite de frecuencia

Confirmar que una clave funciona y a qué puede acceder

/domains

Tus dominios rastreados y sus IDs

El domain_id que necesitan todas las demás llamadas

/prompts

Los prompts que rastreas para un dominio

Auditar o exportar tu lista de prompts

/fanout-queries

Las búsquedas reales que ejecutaron los LLM para responder a tus prompts

Encontrar qué publicar para las búsquedas de IA

/mentions-time-series

Recuento diario de respuestas que mencionaron tu marca

Rastrear la exposición bruta

/visibility-time-series

Porcentaje diario de respuestas que te mencionaron (%)

Rastrear tu tasa de acierto

/citations-time-series

Recuento diario de respuestas que citaron tu sitio

Rastrear menciones de alto valor

/citability-time-series

Porcentaje diario de respuestas que te citaron (%)

Rastrear la tasa de citación

/model-leaderboard

Clasificación de visibilidad por motor en ChatGPT, Perplexity, Gemini, Claude y más

Ver qué motor de IA te posiciona mejor

/brand-rankings

Tú y tus competidores rastreados, clasificados por menciones, visibilidad y cuota de voz

Evaluación comparativa con los competidores que rastreas

/citations

Cada URL citada para tus prompts, clasificada por tipo de página (tuya, de competidores, de terceros)

Encontrar qué se cita y dónde proponer colaboraciones

Construir con la API

Paso 1: Comprueba que tienes acceso

La API está disponible en los planes Pro, Business y Enterprise. En el plan Starter, primero tendrás que actualizar tu suscripción.

Paso 2: Crea una clave 

En la aplicación, abre Configuración → Desarrolladores y haz clic en Crear clave de API. Copia la clave (comienza con ak_live_) y guárdala en un lugar seguro. No podrás volver a verla completa.

AIclicks api key

Paso 3: Valídala antes de construir nada 

Una llamada a GET /api/v1/validate confirma que la clave está activa y muestra a qué equipos y dominios puede acceder. Ejecútala primero cuando algo más adelante devuelva un error 401 o 403.

Una sola llamada confirma que la clave funciona y muestra exactamente a qué puede acceder:

curl https://api.aiclicks.io/api/v1/validate \

  -H "Authorization: Bearer TU_CLAVE_API"

Recibirás de vuelta tus equipos, los dominios que la clave tiene permiso para tocar y tu límite de frecuencia:

{

"data": {

"valid": true,

"key_type": "api_key",

"key": {

"id": "fae8acf7-5117-460c-a75e-5fbafc097dfb",

"name": "new",

"created_at": "2026-06-08T09:45:02.282446+00:00"

},

"user_id": "440b3def-e5f5-4bb2-8634-04f4887bff35",

"teams": [

{

"id": "7a08f3a3-529a-4b4f-9166-988a9e7f635c",

"name": "Leapsly2",

"developer_access": true,

"domains_count": 24

}

],

"allowed_domains": null,

"rate_limit": {

"limit_per_minute": 60,

"remaining": 60,

"reset_at": 1782724651

}

},

"generated_at": "2026-06-29T09:16:34.992500+00:00"

}

Si developer_access se muestra como false, la clave es válida pero el acceso a la API aún no está activado para el equipo. Eso es lo primero que debes comprobar cuando una llamada devuelva un resultado vacío.

Paso 4: Obtén tu domain_id 

Al llamar a GET /api/v1/domains obtendrás todos los dominios que la clave puede ver, cada uno con un ID. Debes pasar ese domain_id a cada endpoint de datos.

Muestra la lista de tus dominios y copia el ID que deseas:

curl https://api.aiclicks.io/api/v1/domains \

  -H "Authorization: Bearer TU_CLAVE_API"

Paso 5: Extrae tus datos

Usa la Referencia de la API para encontrar el endpoint que necesitas. Esto devuelve la visibilidad diaria de los últimos 90 días:

/api/v1/visibility-time-series?domain_id=DOMAIN_ID&days=90

curl "https://api.aiclicks.io/v1/domains/isibility-time-series?domain_id=DOMAIN_ID&days=90" \

  -H "Authorization: Bearer TU_CLAVE_API"

Cada respuesta se devuelve en formato JSON con un campo de datos (data) y una marca de tiempo generated_at. La paginación, los intervalos de fechas y el resto de los endpoints se encuentran en la referencia de la API.

Valida, encuentra tu dominio, extrae los datos. Tienes un límite de 60 solicitudes por minuto, lo que cubre cómodamente los informes y las sincronizaciones diarias. Espacia las tareas pesadas para no alcanzar el límite.

O simplemente pregunta, con el MCP

Si prefieres no escribir llamadas de código, conecta el MCP y pregunta a tu asistente de IA. 

Lo alojamos en https://mcp.aiclicks.io/mcp, se comunica mediante HTTP con soporte para streaming, utiliza la misma clave ak_live_ que la API y funciona con Claude Desktop, Claude Code, Cursor y cualquier otro cliente de MCP.

AIclicks API key

Una vez que esté conectado, puedes preguntar cosas como:

  • "¿Qué tan visible es mi marca en las búsquedas de IA esta semana?"

  • "¿Qué fuentes están citando los LLM cuando nos mencionan?"

  • "Compara nuestra cuota de voz con la de la competencia durante los últimos 30 días."

  • "¿Qué prompts están perdiendo visibilidad mes a mes?"

  • "¿En qué aspectos tenemos un rendimiento inferior en Claude en comparación con ChatGPT?"

Tu asistente dirige cada pregunta a la herramienta adecuada y te devuelve cifras en tiempo real. Los pasos detallados para cada cliente se encuentran en docs.aiclicks.io/setup; a continuación se muestran las versiones rápidas.

Claude en la web

Esta es la forma más sencilla de añadir AIclicks a Claude.

Paso 1: En Claude, ve a Personalizar → Conectores (Customize → Connectors).

Paso 2: Haz clic en + → Añadir conector personalizado (Add custom connector) e introduce:

Deja en blanco el encabezado de Autorización. Eso es lo que inicia el proceso de inicio de sesión.

Paso 3: Haz clic en Conectar. Se abrirá una ventana que te dirigirá a AIclicks. Inicia sesión si es necesario, elige el equipo al que concederás acceso y haz clic en Permitir.

Paso 4: Inicia una nueva conversación y pregunta: "Enumera mis dominios de AIclicks." Si los muestra, ya estás conectado.

¿Usas Claude Desktop, Cursor u otro cliente?

Esos se conectan usando tu clave ak_live_ en lugar de iniciar sesión. El método más rápido es Claude Code, con un solo comando:

claude mcp add --transport http aiclicks https://mcp.aiclicks.io/mcp \

--header "Authorization: Bearer TU_CLAVE_API"

Ejecuta `claude mcp list` y aiclicks debería aparecer como Conectado.

Para Claude Desktop, Cursor y cualquier otro cliente, la configuración exacta para cada uno se encuentra en la página de configuración. La lista completa de herramientas y los prompts listos para usar están en la documentación del MCP.

Cinco formas de ponerlo a trabajar

Ya tienes una clave y datos fluyendo a través de ella. Aquí es donde esos datos se ganan su lugar en tu semana, desde una simple recopilación de informes hasta el endpoint que te dice qué publicar a continuación.

1. Saca tu visibilidad de IA fuera del panel de control

Actualmente, tu visibilidad, citas y menciones viven dentro de AIclicks. Tu gasto en publicidad está en un lugar, tus cifras orgánicas en otro, tus ingresos en un tercero. 

La API te permite extraer las cuatro series temporales en el mismo Looker, Metabase o Google Sheet que el resto de tus datos de marketing, de modo que la búsqueda de IA aparezca en la vista semanal que ya consultas, en lugar de en una pestaña que tienes que acordarte de abrir. 

Extráelos de forma programada y tendrás una fuente de información en directo.

2. Convierte las consultas de distribución (fan-out) en una hoja de ruta de contenido

Este es el endpoint por el que debes empezar. 

Cuando un LLM responde a uno de tus prompts rastreados, realiza sus propias búsquedas en segundo plano para fundamentar la respuesta. /fanout-queries devuelve esas búsquedas reales, agrupadas bajo el prompt que las originó y atribuidas al modelo que las ejecutó. 

Esa lista es la señal más clara que existe sobre "qué debería escribir para ser citado", porque es lo que los modelos ya están buscando sobre tus temas.

Extrae los datos de 90 días, unifica el resultado y cuenta con qué frecuencia se repite cada consulta. Las que estén al principio son tus próximas pautas de redacción. Filtra por modelo y podrás ver qué busca ChatGPT que Perplexity no busca.

Haz esto: extrae las consultas de distribución (fan-out) de tu dominio principal, ordénalas por frecuencia y entrégale las 20 principales a quien escriba tus contenidos.

Aquí tienes un vistazo:

Bastante simple, ¿verdad?

¡Anímate a probarlo!

3. Conéctalo con tu arsenal de SEO

AIclicks te dice dónde te menciona y te cita la IA. Tu rastreador de posiciones te dice dónde te sitúas en la búsqueda clásica. 

Coloca ambos datos frente a frente con la API y las brechas surgirán por sí solas: prompts donde la competencia recibe citas y tú no, temas en los que te posicionas en Google pero sigues ausente en las respuestas de la IA. Obtén más información sobre cómo ser citado por la IA.

Cada brecha representa una página específica que escribir o un sitio web específico al que proponer una colaboración.

4. Diseña informes que se ejecuten solos

Si exportas archivos CSV manualmente cada mes para una presentación de clientes o una actualización ejecutiva, los endpoints de series temporales reemplazan ese trabajo. 

Apunta un script o un flujo de automatización a las series de visibilidad y citas, dale formato una vez y el informe se reconstruirá solo según la programación que definas. 

Dado que la API es de solo lectura, una tarea programada solo podrá generar informes, nunca alterar tu configuración, lo cual es exactamente el comportamiento que deseas para algo que se ejecuta de forma desatendida.

Si gestionas cuatro o más clientes, esto te ahorra una mañana entera de copiar y pegar.

5. Supervisa cada marca desde un único tablero

Para agencias y equipos que gestionan múltiples marcas, realiza un bucle sobre /domains, extrae las mismas métricas para cada uno y tendrás un único panel de visibilidad para todos los clientes sin necesidad de abrir un espacio de trabajo por cuenta. 

Un solo vistazo te dirá quién subió y quién bajó esta semana, y dónde debes centrar tus esfuerzos de difusión y menciones a continuación.

Antes de construir, algunas aclaraciones

Vale la pena saberlo antes de integrar cualquiera de los dos:

  • Ambos son de solo lectura. Puedes leer cada métrica, pero no puedes añadir prompts ni cambiar configuraciones a través de ellos. Eso se sigue haciendo en la aplicación.

  • La mayoría de los datos se guardan en caché durante aproximadamente una hora. Un cambio que realices en el panel se reflejará después de que se borre la caché, no en el mismo instante en que lo hagas.

  • El límite de frecuencia predeterminado es de 60 solicitudes por minuto por clave, compartido entre la API y el MCP. Es más que suficiente para la elaboración de informes. Enumera los dominios en una sola llamada, luego espacia o guarda en caché las extracciones por dominio (cada una es una solicitud, compartiendo el límite de 60/min).

  • Una clave solo ve los dominios para los que está habilitada. Ejecuta /validate (o pregúntale al MCP) si falta algún dominio que esperabas encontrar.

  • Los días individuales fluctúan mucho. Analiza la tendencia a 30 y 90 días, no una fecha concreta.

Actívalo

¿Estás en Pro, Business o Enterprise? Abre Configuración → Desarrolladores y crea una clave. A partir de ahí:

  • Para construir, la referencia completa de endpoints está en docs.aiclicks.io/api.

  • Para simplemente preguntar, conecta el servidor MCP a Claude o Cursor usando esa misma clave.

¿Aún no estás en esos planes? El acceso a la API y al MCP se incluye con Pro, Business y Enterprise. Si ya extraes la visibilidad de la IA en informes de forma manual, se amortiza solo con el tiempo que dejas de gastar en exportaciones.

Eso es todo sobre la API y el MCP. Anímate a construir algo con ellos.

¿Hay alguna función que te gustaría ver próximamente? Envíanosla a nuestro tablero de solicitudes de funciones. Las leemos todas.

¿Nuevo en AIclicks? Comienza tu prueba gratuita de 3 días.

Fundador @ aiclicks.io

Fundador @ aiclicks.io

Rokas es el fundador de AIclicks.io. Comenzó a desarrollar la herramienta para ayudar a las marcas a comprender y aumentar su visibilidad en los motores de búsqueda de IA. Escribe sobre SEO para IA, datos de prompts y el futuro del descubrimiento en la era de los LLM.

Rokas es el fundador de AIclicks.io. Comenzó a desarrollar la herramienta para ayudar a las marcas a comprender y aumentar su visibilidad en los motores de búsqueda de IA. Escribe sobre SEO para IA, datos de prompts y el futuro del descubrimiento en la era de los LLM.

¿Te gustó lo que leíste? Obtén tu guía definitiva de SEO con IA aquí:

¿Te gustó lo que leíste? Obtén tu guía definitiva de SEO con IA aquí:

Usa AIclicks para optimizar para SEO de IA mediante el seguimiento, análisis y mejora de tus menciones en las respuestas de IA.

Usa AIclicks para optimizar para SEO de IA mediante el seguimiento, análisis y mejora de tus menciones en las respuestas de IA.

Usa AIclicks para optimizar para SEO de IA mediante el seguimiento, análisis y mejora de tus menciones en las respuestas de IA.

¿Te queda alguna duda?
Reserva una llamada aquí: