Listo para trabajar por API y con agentes de IA
Todo lo que importa para generar leads en Cold Leads es accesible por HTTP: verificar direcciones, encontrar correos por nombre y dominio, enviar leads desde cualquier formulario o sistema, mover contactos por el embudo. Entregue a un agente la especificación OpenAPI (verificación, búsqueda de correos, búsqueda de contactos, créditos) y los dos hooks de abajo, y trabajará con el CRM como herramienta, sin nadie copiando datos entre ventanas.
Dos tipos de claves, alcance claro
Las claves viven en Ajustes → Claves de API y se crean con un clic. Las claves web (lk_…) son públicas: solo pueden crear contactos y son seguras dentro de un formulario en su web. Las claves secretas (sk_…) desbloquean la API de verificación y el hook de fase, se guardan con hash y se pueden pausar, regenerar o eliminar en cualquier momento. Cada clave muestra cuándo se usó por última vez.
Los endpoints
Envíe la clave secreta en la cabecera x-api-key. Todas las respuestas son JSON; los errores llevan un código corto como rate_limited o bad_input.
POST /api/v1/verify { "email": "jane@example.com" }
POST /api/v1/verify/bulk { "emails": ["…"], "name": "expo-2026" } → job id
GET /api/v1/verify/jobs/{id} → progress and valid / risky / invalid counts; ?results=1 adds per-address results
POST /api/v1/find { "name": "Jane Doe", "domain": "example.com" }
GET /api/v1/credits → credits left this month
POST /api/hooks/lead email, name, company, phone, message, tag (lk_ website key)
POST /api/hooks/stage { "email": "jane@example.com", "stage": "customer" }
GET /api/v1/leads?domain=example.com → contacts already in your own CRM (0 credits)
POST /api/mcp MCP for AI agents: search_leads, verify_email
Límites: 120 peticiones por minuto por clave · 5 tareas en paralelo · 5 000 direcciones por tarea · 1 crédito por dirección verificada o búsqueda de direcciónConéctelo a un agente de IA
La especificación en /api/v1/openapi.json (OpenAPI 3.1) describe los endpoints de /api/v1 con sus esquemas (los dos hooks de arriba son llamadas HTTP simples), así que un agente puede llamarlos sin código a medida:
- ChatGPT: cree un GPT, importe la especificación como Action y configure la autenticación por clave de API con la cabecera x-api-key.
- Claude y cualquier modelo con llamada a funciones: genere las definiciones de herramientas a partir de la especificación, añada el hook de leads y deje que el modelo verifique, encuentre y envíe en una sola conversación.
- Copilot Studio, n8n, Make, Zapier: basta un nodo HTTP con la misma cabecera; el id de la tarea masiva convierte las listas largas en un flujo de dos pasos.
- Una ejecución típica de un agente: tomar una lista de una hoja de cálculo, verificarla, descartar las direcciones no válidas, enviar las válidas con una etiqueta y pasar un contacto a «cliente» cuando se cierra el trato.
SDK de Node.js y servidor MCP
En GitHub hay dos clientes de código abierto para esta API con licencia MIT, y se instalan directamente desde allí. El SDK de Node.js es un cliente tipado para Node 20 o posterior. El servidor MCP permite que Claude Desktop, Cursor, VS Code y otros clientes MCP capaces de iniciar un servidor local usen Cold Leads como herramienta.
Los agentes compatibles con MCP por HTTP no necesitan instalar nada: se conectan a https://coldleads.app/api/mcp con una clave secreta en la cabecera Authorization: Bearer.
Automatización después de la llamada
Los contactos enviados a través de una clave pueden iniciar una campaña automática tras el retraso que usted defina: el correo de bienvenida o de seguimiento sale desde su propio buzón con prueba en seco, límites diarios y ritmo humano. El hook de fase permite que su sistema de facturación o CRM marque un contacto como cliente en el momento en que se cierra el trato, así el embudo se mantiene fiel sin que nadie edite registros.
Planes y límites
Las claves web funcionan en todos los planes. Las claves secretas — la API de verificación y búsqueda y el hook de fase — forman parte de Business (99 € / $99 al mes) junto con 10.000 créditos al mes; los paquetes extra cuestan 5 € / $5 por 1 000. Los resultados se guardan en caché 30 días (cada comprobación cuesta igualmente 1 crédito) y todas se ejecutan desde los servidores de Cold Leads, nunca desde su dominio.
Preguntas frecuentes
¿Hay un servidor MCP o un SDK?
Sí. El SDK de Node.js y el servidor MCP son de código abierto en GitHub (vea «SDK de Node.js y servidor MCP» más arriba), y los agentes pueden conectarse al endpoint MCP alojado en https://coldleads.app/api/mcp. Otros frameworks importan directamente la especificación OpenAPI 3.1.
¿Puede un agente lanzar campañas?
Las campañas se lanzan desde la aplicación tras una prueba en seco, a propósito. Los agentes aportan contactos, etiquetas y fases; una campaña automática vinculada a la clave envía después la secuencia de correos.
¿Cómo se protegen las claves?
Las claves secretas se guardan con hash y se muestran una sola vez. Pause o regenere una clave en Ajustes; las peticiones con una clave pausada se rechazan. Cada clave tiene su propio límite de peticiones y contador de uso.
¿Qué devuelve una llamada de verificación?
Un estado válida, arriesgada o no válida, una puntuación, códigos de motivo, el servidor MX y el campo catch_all, que solo es true cuando la comprobación de accept-all se ejecutó y el servidor aceptó una dirección inventada — el mismo resultado que la app usa para sus propias campañas.