¿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, menciones y referencias, los prompts de los que hace un seguimiento 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. Lleve sus datos a un almacén de datos, una herramienta de BI, un informe programado o a su propio script.

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

Use el que mejor se adapte a su forma de trabajar, o ambos. 

Comparten la misma clave ak_live_, ambos están disponibles en los planes 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 manera

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

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

Construya con la API

Paso 1: Verifique que tiene acceso

La API está disponible en los planes Business y Enterprise. Cada clave está restringida a un equipo, y dicho equipo necesita tener activado el acceso de desarrollador. En los planes Starter o Pro, primero deberá realizar una actualización de plan.

Paso 2: Cree una clave 

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

Paso 3: Valídela antes de construir cualquier cosa 

Una llamada a GET /api/v1/validate confirma que la clave está activa y muestra los equipos y dominios a los que puede acceder. Ejecútela primero siempre que algo más adelante en el flujo 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/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 solicitudes:

{

  "valid": true,

  "key_type": "api_key",

  "teams": [{ "name": "AIclicks", "developer_access": true, "domains_count": 3 }],

  "allowed_domains": [

    { "id": "10df2f96-...", "name": "AIclicks", "website": "https://aiclicks.io/" }

  ],

  "rate_limit": { "limit_per_minute": 60, "remaining": 59 }

}

Si el campo 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 

Llamar a GET /api/v1/domains devuelve todos los dominios que la clave puede ver, cada uno con un identificador (ID). Deberá pasar ese domain_id a cada endpoint de datos.

Enumere sus dominios y copie el ID que desee:

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

  -H "Authorization: Bearer SU_CLAVE_API"

Paso 5: Extraiga sus datos

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

curl "https://api.aiclicks.io/v1/domains/DOMAIN_ID/visibility?days=90" \

  -H "Authorization: Bearer SU_CLAVE_API"

Cada respuesta regresa en formato JSON con un campo 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.

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

O simplemente pregunte, con el MCP

Si prefiere no escribir llamadas, conecte el MCP y pregúntele a su asistente de IA. 

Lo alojamos en https://mcp.aiclicks.io/mcp, utiliza la misma clave ak_live_ key, y funciona con Claude Desktop, Claude Code, claude.ai en la web y Cursor. 

Una vez que esté 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 frente a los competidores durante los últimos 30 días."

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

• "¿Dónde estamos rindiendo por debajo de lo esperado en Claude frente a ChatGPT?"

Su asistente guiará cada pregunta al instrumento adecuado y le devolverá cifras en tiempo real.

Claude Desktop

Paso 1: Obtenga su clave desde Settings → Developers → Create API Key.

Paso 2: En Claude Desktop, vaya a Settings → Developer → Edit Config para abrir claude_desktop_config.json.

Paso 3: Pegue esto dentro de mcpServers y reemplace YOUR_API_KEY por su clave:

{

  "mcpServers": {

    "aiclicks": {

      "command": "npx",

      "args": [

        "-y",

        "mcp-remote",

        "https://mcp.aiclicks.io/mcp",

        "--header",

        "Authorization: Bearer YOUR_API_KEY"

      ]

    }

  }

}

Paso 4: Reinicie Claude Desktop. (Esta ruta utiliza npx, que viene con Node.js. Si no lo tiene, instale la versión LTS desde nodejs.org).

Paso 5: Pregunte: "Valida mi clave de AIclicks y enumera mi dominios". Si muestra sus dominios, ya está conectado.

Claude Code

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 mostrarse como Conectado.

Cursor

Agregue esto a ~/.cursor/mcp.json (global) o a .cursor/mcp.json (por proyecto), luego verifique que el panel de MCP muestre aiclicks como Conectado:

{

  "mcpServers": {

    "aiclicks": {

      "url": "https://mcp.aiclicks.io/mcp",

      "headers": { "Authorization": "Bearer YOUR_API_KEY" }

    }

  }

}

Cualquier otro cliente

Apúntelo a https://mcp.aiclicks.io/mcp sobre HTTP con soporte de flujo, utilizando la cabecera Authorization: Bearer SU_CLAVE_API. Los pasos completos cliente por cliente, la lista completa de herramientas y las recetas de prompts listas para usar se encuentran en la documentación de MCP.

Cinco formas de ponerlo a trabajar

Tiene una clave y datos que emanan de ella. Aquí es donde esos datos ganan su lugar en su rutina semanal, desde una simple extracción para informes hasta el endpoint que le indica qué publicar a continuación.

1. Saque su visibilidad de IA del panel

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

La API le permite extraer las cuatro series temporales 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 en una pestaña que tiene que acordarse de abrir. 

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

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

Este es el endpoint con el que debe empezar. 

Cuando un LLM responde a uno de los prompts que rastrea, ejecuta 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 cercana que existe de "qué debo escribir para que me citen", porque es lo que los modelos ya están buscando sobre sus temas.

Extraiga 90 días, aplane el resultado y cuente con qué frecuencia se repite cada consulta. Las que estén arriba de todo son sus próximos briefings. Filtre por modelo y podrá ver qué busca ChatGPT que Perplexity no.

Haga esto: extraiga las consultas fan-out para su dominio principal, clasifíquelas por frecuencia y entregue las 20 principales a quien escriba sus resúmenes.

He aquí un vistazo:

Bastante simple, ¿verdad?

¡Vaya a probarlo!

3. Crúcelo con su suite de herramientas de SEO

AIclicks le indica dónde le mencionan y enlazan las IA. Su rastreador de posiciones (rank tracker) le muestra dónde se ubica en la búsqueda clásica. 

Coloque ambos datos frente a frente con la API y las brechas surgirán por sí solas: prompts donde la competencia es citada y usted no, temas en los que se posiciona en Google pero permanece ausente en las respuestas de IA. Obtenga más información sobre cómo ser citado por la IA.

Cada brecha representa una página específica que deba escribir o un sitio concreto al cual proponer su contenido.

4. Genere informes que se ejecutan solos

Si exporta archivos CSV de forma manual todos los meses para la presentación de un cliente o una actualización ejecutiva, los endpoints de series temporales reemplazan ese trabajo. 

Dirija un script o un flujo de automatización a las series de visibilidad y menciones web directas, aplique formato una vez y el informe se reconstruirá solo con la frecuencia que defina. 

Como la API es de solo lectura, una tarea programada solo puede generar informes, nunca alterar su configuración, que es exactamente el comportamiento que desea de un proceso que se ejecuta sin supervisión.

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

5. Monitoree cada marca desde un único tablero

Para agencias y equipos con múltiples marcas, recorra cíclicamente /domains, recopile las mismas métricas de cada uno y tendrá un panel de visibilidad que abarca a todos los clientes sin tener que abrir un espacio de trabajo para cada cuenta. 

Una sola mirada le indicará quién subió y quién bajó esta semana, y dónde debe invertir su esfuerzo de difusión y generación de menciones a continuación.

Antes de construir, algunas cosas

Vale la pena saber esto antes de conectar cualquiera de las dos opciones:

• Ambos son de solo lectura. Puede leer cada métrica, pero no puede agregar prompts 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 almacenan en caché durante aproximadamente una hora. Un cambio que realice en el panel se mostrará después de que se borre la caché, no en el instante en que lo haga.

• El límite de solicitudes predeterminado es de 60 solicitudes por minuto por clave, compartido entre la API y el MCP. Espacio de sobra para informes. Agrupe sus llamadas en lotes si está recorriendo cíclicamente muchos dominios.

• Una clave solo ve los dominios para los que está habilitada. Ejecute /validate (o pregunte al MCP) si falta algún dominio que esperaba ver.

• Las mediciones de días individuales fluctúan. Evalúe el comportamiento con base en la tendencia de 30 y 90 días, no por una fecha en específico.

Actívelo

¿Tiene un plan Business o Enterprise? Abra Settings → Developers y cree una clave. A partir de ahí:

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

• Para solo hacer preguntas, conecte el servidor MCP a Claude o Cursor usando esa misma clave.

¿Aún no está en esos planes? El acceso a la API y al MCP viene incluido con el plan Business. Si ya extrae la visibilidad en herramientas de IA para hacer informes a mano, se amortiza solo con el tiempo que dejará de dedicar a realizar exportaciones.

Eso es todo sobre la API y el MCP. Vaya y construya algo con ellos.

¿Tiene alguna función que desee para la próxima versión? Envíela a nuestro panel de solicitudes de funciones. Leemos cada una de ellas.

¿Es nuevo en AIclicks? Comience su prueba gratuita de 3 días.