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

Presentamos la API de AIclicks

Auditoría de visibilidad de IA gratuita

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 vendrían pronto

Por fin ya están disponibles. 🎉

Ambos le brindan acceso de solo lectura a todo lo que ejecuta el panel de control: visibilidad de marca, menciones, citas, las indicaciones que rastrea y las consultas de distribución (fan-out) que los LLM realmente ejecutan para responderle. 

Son dos formas de acceder a los mismos datos.

  • La API es para construir. Extraiga sus datos a un almacén de datos, una herramienta de inteligencia empresarial (BI), un informe programado o su propio script.

  • El MCP es para preguntar. Conecte Claude, Cursor o cualquier asistente de IA y pregunte sobre su visibilidad en español sencillo, sin código.

Use el que mejor se adapte a su 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 ellos toma un par de minutos. Esto es lo que contienen los datos y luego cómo activar cada uno.

Lo que obtiene, de cualquier forma

Todo está construido alrededor de una idea: un dominio, las indicaciones que rastrea para este y cómo responden los motores de IA. 

La API lo expone como ocho puntos finales (endpoints) de lectura; el MCP envuelve los mismos datos como herramientas que su asistente puede llamar. Aquí está el conjunto completo.

Punto final (Endpoint) 

Lo que devuelve

Úselo para

/validate

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

Confirmar que una clave funciona y a qué puede acceder

/domains

Sus dominios rastreados y sus ID

El domain_id que cada otra llamada necesita

/prompts

Las indicaciones que rastrea para un dominio

Auditar o exportar su lista de indicaciones

/fanout-queries

Las búsquedas reales que realizaron los LLM para responder a sus indicaciones

Buscar qué publicar para la búsqueda de IA

/mentions-time-series

Recuento diario de respuestas que nombraron su marca

Rastrear la exposición bruta

/visibility-time-series

Porcentaje diario de respuestas que lo nombraron (%)

Rastrear su tasa de aciertos

/citations-time-series

Recuento diario de respuestas que citaron su sitio

Rastrear menciones de alto valor

/citability-time-series

Porcentaje diario de respuestas que lo citaron (%)

Rastrear la tasa de citas

/model-leaderboard

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

Ver qué motor de IA lo destaca mejor

/brand-rankings

Usted y sus competidores rastreados, clasificados por menciones, visibilidad y cuota de voz

Comparación con los competidores que rastrea

/citations

Cada URL citada para sus indicaciones, clasificada por tipo de página (la suya, de competidores, de terceros)

Buscar qué se cita y dónde proponer contenido

Construya con la API

Paso 1: Verifique que tiene acceso

La API está disponible en los planes Pro, Business y Enterprise. En el plan Starter, primero deberá actualizar su cuenta.

Paso 2: Cree una clave 

En la aplicación, abra Settings (Configuración) → Developers (Desarrolladores) y haga clic en Create API Key (Crear clave API). Copie la clave (comienza con ak_live_) y guárdela en un lugar seguro. No la volverá a ver completa.

AIclicks api key

Paso 3: Valídela antes de construir cualquier cosa 

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

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

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

  -H "Authorization: Bearer SU_CLAVE_API"

Recibirá de vuelta sus equipos, los dominios que la clave tiene permitido tocar y su límite de velocidad:

{

"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 lee 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 debe verificar cuando una llamada regrese vacía.

Paso 4: Obtenga su domain_id 

Hacer una llamada de tipo GET /api/v1/domains devuelve cada dominio que la clave puede ver, cada uno con un ID. Debe pasar ese domain_id a cada punto final de datos.

Enumere sus dominios y copie el ID que desee:

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

  -H "Authorization: Bearer SU_CLAVE_API"

Paso 5: Extraiga sus datos

Use la Referencia de la API para encontrar el punto final que necesita. Esto devuelve la visibilidad diaria de los últimos 90 días:

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

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

  -H "Authorization: Bearer SU_CLAVE_API"

Cada respuesta se devuelve como un JSON con un campo de datos y una marca de tiempo generated_at. La paginación, las ventanas de fechas y el resto de los puntos finales se encuentran en la referencia de la API.

Valide, encuentre su dominio, extraiga los datos. Está limitado a 60 solicitudes por minuto, lo que cubre cómodamente los informes y las sincronizaciones diarias. Espacie los trabajos pesados para no alcanzar el límite.

O simplemente pregunte, con el MCP

Si prefiere no escribir llamadas para nada, conecte el MCP y pregunte a su asistente de IA. 

Lo alojamos en https://mcp.aiclicks.io/mcp, habla HTTP transmitible (streamable), utiliza la misma clave ak_live_ que la API y funciona con Claude Desktop, Claude Code, Cursor y cualquier otro cliente MCP.

AIclicks API key

Una vez conectado, puede preguntar cosas como:

  • "¿Qué tan visible es mi marca en la búsqueda 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é indicaciones están perdiendo visibilidad mes a mes?"

  • "¿En qué aspectos estamos teniendo un rendimiento inferior en Claude frente a ChatGPT?"

Su asistente dirige cada pregunta a la herramienta adecuada y le devuelve números en tiempo real. Los pasos completos para cada cliente se encuentran en docs.aiclicks.io/setup; las versiones rápidas se muestran a continuación.

Claude en la web

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

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

Paso 2: Haga clic en + → Add custom connector (Agregar conector personalizado) e ingrese:

Deje el encabezado de autorización en blanco. Eso es lo que activa el inicio de sesión.

Paso 3: Haga clic en Connect (Conectar). Se abrirá una ventana hacia AIclicks. Inicie sesión si es necesario, elija el equipo al que otorgará acceso y haga clic en Allow (Permitir).

Paso 4: Inicie una nueva conversación y pregunte: "List my AIclicks domains" (Enumera mis dominios de AIclicks). Si los enumera, estarás conectado.

¿Utiliza Claude Desktop, Cursor u otro cliente?

Esos se conectan con su clave ak_live_ en lugar de iniciar sesión. El 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 SU_CLAVE_API"

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

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

Cinco formas de ponerlo a trabajar

Tiene una clave y datos saliendo de ella. Aquí es donde esos datos se ganan su lugar en su semana, desde una simple extracción de informes hasta el punto final que le dice qué publicar a continuación.

1. Saque su visibilidad de IA fuera del panel de control

En este momento su visibilidad, citas y menciones viven dentro de AIclicks. Su inversión publicitaria se encuentra en un lugar, sus números orgánicos en otro, sus ingresos en un tercero. 

La API le permite extraer las cuatro series de tiempo en el mismo Looker, Metabase o Google Sheet que el resto de sus datos de marketing, de modo que la búsqueda de IA aparezca en la vista semanal que ya lee en lugar de tener que recordar abrir una pestaña. 

Extráigalos de forma programada y tendrá una transmisión de datos en vivo.

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

Este es el punto final por el que debe empezar. 

Cuando un LLM responde a una de las indicaciones que usted rastrea, realiza sus propias búsquedas en segundo plano para fundamentar la respuesta. /fanout-queries devuelve esas búsquedas reales, agrupadas bajo la indicación que las desencadenó y atribuidas al modelo que las ejecutó. 

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

Extraiga datos de 90 días, aplane el resultado y cuente con qué frecuencia se repite cada consulta. Las que estén en la parte superior son sus próximos resúmenes (briefs). Filtre por modelo y podrá ver lo que ChatGPT está buscando y que Perplexity no.

Haga esto: extraiga las consultas de distribución de su dominio principal, clasifíquelas por frecuencia y entregue las 20 principales a quien escriba sus resúmenes.

Aquí hay un vistazo:

Bastante simple, ¿no?

¡Vaya y pruébelo!

3. Únalo con su conjunto de herramientas de SEO

AIclicks le dice dónde lo menciona y cita la IA. Su rastreador de clasificación le dice dónde se ubica en la búsqueda clásica. 

Ponga ambos lado a lado con la API y las brechas surgirán por sí solas: indicaciones donde se cita a los competidores y a usted no, temas en los que clasifica en Google pero está ausente de las respuestas de IA. Obtenga más información sobre cómo ser citado por la IA.

Cada brecha es una página específica para escribir o un sitio específico para proponer contenido.

4. Cree informes que se ejecuten solos

Si exporta archivos CSV a mano todos los meses para una presentación de clientes o una actualización para directivos, los puntos finales de las series de tiempo reemplazan ese trabajo. 

Apunte un script o un flujo de automatización a las series de visibilidad y citas, dele formato una vez y el informe se reconstruirá solo en el horario de programación que elija. 

Debido a que la API es de solo lectura, un trabajo programado solo puede generar informes, nunca tocar su configuración, que es exactamente el comportamiento que desea de algo que se ejecuta sin supervisión.

Si gestiona cuatro o más clientes, esto reemplaza una mañana de copiar y pegar.

5. Observe cada marca desde un solo tablero

Para agencias y equipos con múltiples marcas, realice un bucle sobre /domains, extraiga las mismas métricas para cada uno y tendrá un tablero de visibilidad único de todos los clientes sin tener que abrir un espacio de trabajo por cuenta. 

Un solo vistazo le dirá quién subió y quién bajó esta semana, y dónde dedicar sus esfuerzos de difusión y mención a continuación.

Antes de construir, algunas cosas

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

  • Ambos son de solo lectura. Puede leer cada métrica, pero no puede agregar indicaciones ni cambiar la configuración a través de ellos. Eso todavía se hace en la aplicación.

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

  • El límite de velocidad predeterminado es de 60 solicitudes por minuto por clave, compartido entre la API y el MCP. Es suficiente para la emisión de informes. Enumere los dominios en una llamada, luego espacie/guarde en caché las extracciones por dominio, cada una es una sola solicitud, compartida a 60/min.

  • Una clave solo ve los dominios a los que está destinada. Ejecute /validate (o pregunte al MCP) si falta un dominio que esperaba.

  • Los días individuales fluctúan. Observe la tendencia de 30 y 90 días, no una fecha específica.

Actívelo

¿Está en los planes Pro, Business o Enterprise? Abra Settings (Configuración) → Developers (Desarrolladores) y cree una clave. A partir de ahí:

  • Para construir, la referencia completa de los puntos finales se encuentra en docs.aiclicks.io/api.

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

¿Aún no está en esos planes? El acceso a la API y al MCP se incluye en los planes Pro, Business y Enterprise. Si ya está extrayendo de forma manual la visibilidad de IA en sus informes, vale la pena por el tiempo que dejará de invertir en las exportaciones.

Eso es la API y el MCP. Vaya a construir algo con ellos.

¿Tiene alguna función que desee a continuación? Envíela a nuestro tablero de solicitudes de funciones. Leemos cada una de ellas.

¿Es nuevo en AIclicks? Comience su 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í: