Gemlead en tu CRM, tu stack y tu IA.

Una API de generación de leads en X permite que tus propias herramientas reciban los compradores encontrados en X, y actúen sobre ellos, sin que nadie exporte una lista a mano. La API de Gemlead te da los leads que sus agentes encuentran y puntúan en X, cada uno con su puntuación y el motivo, además de los buyer personas, las campañas, las conversaciones y los DM que hay detrás. Los webhooks firmados llaman a tu servidor en cuanto un lead se calienta o responde, y un servidor MCP deja que Claude, ChatGPT o Cursor manejen tu Gemlead con palabras sencillas. Las tres piezas vienen con el plan Business, con una sola clave.

Lo que importa es la velocidad: un lead caliente que espera en una pestaña hasta que alguien lo copia en el CRM es un lead que se enfría. A continuación: lo que cuesta ese retraso, qué hace cada pieza y una petición real.

Por qué tus leads de X tienen que llegar a tu stack

Los leads que se quedan en una herramienta aparte se trabajan tarde, o nunca.

• Las herramientas desconectadas lo frenan todo. Más de la mitad de los responsables de ventas con IA, el 51%, dice que los sistemas desconectados están frenando sus iniciativas de IA, y el 74% de los profesionales de ventas se está centrando en limpiar sus datos, según el State of Sales 2026 de Salesforce, una encuesta a 4 050 profesionales de ventas.
• Copiar datos se come el tiempo de venta. El vendedor medio dedica el 40% de su tiempo a vender. Los comerciales de la generación Z están en el 35%, y pierden unas dos horas completas a la semana introduciendo datos a mano, según el mismo informe.
• Los leads calientes se enfrían rápido. En un estudio de la Harvard Business Review sobre 1,25 millones de leads, las empresas que intentaron contactar con un lead en menos de una hora tuvieron casi siete veces más probabilidades de calificarlo que las que esperaron más.
• La investigación se está pasando a la IA. Gartner prevé que en 2027 el 95% de los flujos de investigación de los vendedores empezará con IA, frente a menos del 20% en 2024.

Qué hacen la API de generación de leads en X, el servidor MCP y los webhooks de Gemlead

La API REST

Todos los endpoints están bajo https://gemlead.ai/api/v1 y usan JSON. En Gemlead, abre API en el menú, elige la cuenta de X, ponle nombre a la clave y elige sus permisos, read solo o read y write. La clave empieza por gl_live_, se muestra una sola vez y solo ve los datos de esa cuenta de X.

Lo que cubre:

• Leads: lístalos con filtros como hot, score_min, un buyer persona o una fecha, consulta de dónde vino un lead, vuelve a puntuarlo, síguelo o guarda en él tus propios metadata, como un ID de CRM.
• Buyer personas y fuentes: crea un buyer persona, añade fuentes, cambia ajustes, compártelo con tus otras cuentas de X.
• Campañas: crea un borrador a partir de una plantilla, iníciala o ponla en pausa, consulta sus estadísticas y sus tendencias día a día.
• Conversaciones: lee las conversaciones, envía un DM con texto, una imagen, un GIF, un video o una nota de voz, reacciona, mueve una conversación en tu pipeline.
• Exportaciones y analíticas: una exportación de tus leads en CSV o JSON Lines, y los gráficos de tu Panel.
• Julien AI: pregunta al asistente de IA de Gemlead por tu cuenta desde tu código.

Tus leads calientes, los más nuevos primero:

curl -G https://gemlead.ai/api/v1/leads \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -d hot=true \
  -d limit=10

Cada lead vuelve con su perfil de X, su score de 0 a 100, su score_reason en una frase, su buyer persona y su estado. Una clave hace 120 peticiones por minuto. Los DM enviados por la API tienen un tope de 10 por minuto y 300 al día por cuenta de X, o menos si X fija una cuota más baja.

Webhooks

Registra una URL HTTPS pública en la app, en API, o con POST /v1/webhook_endpoints, y elige tus eventos:

Cada petición lleva una cabecera Gemlead-Signature, un HMAC SHA256 que compruebas con el secreto de tu endpoint. Una entrega fallida se reintenta 7 veces, durante unas 45 horas. Puedes tener hasta 10 endpoints por cuenta, y limitar uno a los leads de algunos buyer personas. La guía de webhooks muestra la comprobación en Node.js y en Python.

El servidor MCP

El Model Context Protocol es un estándar de código abierto para conectar aplicaciones de IA con sistemas externos. El servidor de Gemlead en https://gemlead.ai/mcp da a Claude, ChatGPT, Cursor y Claude Code más de 60 herramientas, una por cada cosa que hace la API: search_leads, get_campaign_stats, list_conversations, send_message, create_export y más. Claude y ChatGPT inician sesión con OAuth, sin clave que copiar. En Claude Code, un solo comando:

claude mcp add --transport http gemlead https://gemlead.ai/mcp \
  --header "Authorization: Bearer $GEMLEAD_API_KEY"

Y luego pregunta: «Muéstrame los leads calientes de hoy de mi buyer persona Tipsters, con el motivo por el que cada uno puntuó alto». Las herramientas de escritura necesitan el permiso write, y el asistente te pregunta antes de enviar, iniciar o borrar nada. Para trabajar con varias cuentas de X, añade una conexión por cuenta. La configuración completa está en la documentación.

Por qué funciona

• El push gana al polling. Un webhook llega a tu servidor en cuanto un lead se calienta, así tu CRM o tu comercial lo tiene dentro de esa primera hora, sin gastar peticiones en comprobarlo.
• Un registro por lead. Guarda tu ID de CRM en los metadata del lead, y cada evento posterior enlaza con el mismo registro. Menos duplicados, menos limpieza.
• Los asistentes de IA ya hablan MCP. Anthropic informa de más de 10 000 servidores MCP públicos activos y más de 97 millones de descargas mensuales del SDK, con MCP adoptado por ChatGPT, Cursor, Gemini, Microsoft Copilot y Visual Studio Code. Gartner prevé que el 60% del trabajo de los vendedores B2B pase por interfaces de IA conversacional en 2028.
• Los agentes necesitan buenos datos. Gartner prevé que en 2028 menos del 40% de los vendedores dirá que los agentes de IA mejoraron su productividad. Dar a los tuyos leads puntuados con un motivo para cada puntuación, en lugar de una lista en bruto, es la forma de acabar entre los vendedores que sí notan la mejora.

Exportaciones manuales o la API de Gemlead

Para quién es la API

• Desarrolladores y RevOps que sincronizan los leads de X con HubSpot, Salesforce, Pipedrive, Attio, Notion o Google Sheets, con su propio código o con una herramienta de automatización que recibe webhooks.
• Fundadores que trabajan en Claude o ChatGPT y quieren sus leads calientes y sus respuestas en el mismo chat.
• Agencias que reportan a sus clientes desde los endpoints de analíticas, con una clave por cada cuenta de X de cliente.
• Equipos que crean sus propios agentes de IA, y les dan los leads puntuados de Gemlead y sus herramientas de DM en lugar de un scraper.
• Vendedores B2C, como un tipster deportivo o un creador con una comunidad de pago, que quieren cada lead caliente en la herramienta de su equipo.

Cómo se encuentran esos leads está en cómo encontrar leads en X. Antes de que un agente les escriba, lee lo que un SDR de IA puede y no puede hacer.

Buenas prácticas

1. Una clave por herramienta, guardada en tu servidor en una variable de entorno como GEMLEAD_API_KEY. Da write solo a las herramientas que cambian datos.
2. Verifica cada webhook. Comprueba la firma sobre el cuerpo en bruto y rechaza las marcas de tiempo de más de 5 minutos.
3. Responde rápido, procesa después. Responde con un 2xx en menos de 10 segundos y luego procesa el evento en una cola. La entrega es al menos una vez, así que omite los id de evento que ya hayas procesado.
4. Exporta para el volumen. Una exportación gana a cientos de páginas.
5. Lee antes de permitir. A un asistente lo puede engañar un texto que lee. Comprueba lo que va a hacer una herramienta de escritura antes de aprobarla.

FAQ