HeyLead

npx add-mcp 'https://heylead.dev/mcp'

HeyLead

Tu agente de ventas con IA. Un solo comando para llenar tu pipeline.

HeyLead es un SDR autónomo de LinkedIn nativo de MCP que funciona dentro de Cursor, Claude Code o cualquier editor compatible con MCP. Inicia sesión en la web, luego habla con tu IA y di "encuentra leads".

---

Primeros pasos

MCP (Model Context Protocol) permite que los asistentes de IA usen herramientas externas. HeyLead le da a tu IA la capacidad de hacer prospección en LinkedIn por ti.

Necesitas: Cursor o Claude Code — cualquier editor de IA compatible con MCP.

Paso 1: Instala HeyLead

HeyLead se ejecuta localmente a través de stdio. Necesitas uv:

Claude Code:

claude mcp add heylead -- uvx heylead

Cursor: Configuración > MCP > "Agregar nuevo servidor MCP" > Nombre: heylead, Comando: uvx heylead

Cualquier cliente MCP:

{
  "heylead": {
    "command": "uvx",
    "args": ["heylead"]
  }
}

Actualiza con uvx --refresh heylead.

Paso 2: Configura tu cuenta

Opción A — Alojado (lo más fácil): haz el cuestionario de 90 segundos o inicia sesión en heylead.dev/dashboard/login. Las personas de tu cuestionario se convierten en un borrador de campaña. Conecta LinkedIn en Configuración → Cuentas conectadas, luego lanza desde el panel — o copia tu mensaje de configuración desde Configuración → Integraciones → Cliente de chat a tu chat de IA. Nada se envía antes de que lances. Los usuarios alojados comparten un directorio profesional; las campañas y bandejas de entrada permanecen privadas.

Opción B — Autoalojado: ejecuta todo contra tus propias cuentas. Necesitas dos cosas primero:

1. Una cuenta de Unipile — esto es lo que se comunica con LinkedIn. Regístrate en unipile.com, luego coloca el DSN y la clave API de la página de Access Tokens en ~/.heylead/config.json como unipile_api_url y unipile_api_key.
2. Una clave API de LLM — las llamadas de IA se te facturan a ti. Una clave de Gemini gratuita es suficiente para empezar.

Luego abre tu chat de IA y di:

"Configura mi perfil de HeyLead con esta clave de Gemini: TU_CLAVE"

Recibirás un enlace de autenticación de LinkedIn. Ábrelo, conecta LinkedIn, luego di "terminar configuración". HeyLead obtiene tu perfil y analiza tu estilo de escritura.

Paso 3: Encuentra leads

"Find me CTOs at fintech startups in New York"
"Send outreach to the campaign"
"Check my replies"
"How's my outreach doing?"

---

Cómo funciona

1. Define tu ICP — "Genera un ICP para fundadores de SaaS de IA" → personas impulsadas por RAG con puntos débiles, barreras y segmentación de LinkedIn
2. Crea una campaña — "Encuéntrame CTOs de fintech" → busca en LinkedIn, puntúa prospectos por ajuste
3. Calienta prospectos — Interactúa con sus publicaciones (comentarios, me gusta) antes de contactarlos
4. Envía invitaciones personalizadas — Mensajes con coincidencia de voz que suenan como tú, no como un bot
5. Haz seguimiento automáticamente — Secuencias de múltiples contactos después de que se acepten las conexiones
6. Gestiona respuestas — Detecta sentimiento, avanza leads positivos hacia reuniones, responde preguntas
7. Rastrea resultados — Seguimiento de ganado/perdido/optado fuera con análisis de conversión

Modelo de seguridad: las campañas se crean como borradores y solo se inician cuando tú las lanzas explícitamente. Cada envío pasa límites de velocidad, verificaciones de horario laboral y una protección de conexión de 1er grado antes de salir. Lanzar también es lo que activa el envío en la nube 24/7 — en modo observe nada se activa y nada se envía, desde ninguna máquina.

---

Herramientas

HeyLead le da a tu IA 35 herramientas:

Flujo de trabajo principal

Herramienta	Qué hace
setup_profile	Conecta LinkedIn y analiza tu estilo de escritura en una firma de voz
generate_icp	Genera un Perfil de Cliente Ideal enriquecido con personas compradoras
icp	Previsualiza qué perfiles de LinkedIn coinciden con un ICP guardado, sin crear una campaña
profile_signals	Compila una solicitud de segmentación (vínculos de país, intereses) en consultas de recuperación de LinkedIn y puntuación de evidencia de perfil
create_campaign	Crea una campaña de prospección (como borrador) a partir de una descripción en lenguaje natural
generate_and_send	Genera un mensaje personalizado de LinkedIn y lo envía
check_replies	Verifica nuevas respuestas en todas las campañas, clasifica sentimiento, muestra leads calientes
book_meeting	Coloca una llamada acordada en tu Google Calendar y envía al prospecto una invitación
show_status	Tu panel — campañas, estadísticas, leads calientes, salud de la cuenta. Enlaza a la página correspondiente de heylead.dev/dashboard y, en cuentas alojadas, adjunta una tarjeta de instantánea

Prospección y compromiso

Herramienta	Qué hace
send_message	Envía seguimientos, respuestas o notas de voz a prospectos
send_email	Envía correos electrónicos a través de un buzón de Unipile conectado (Gmail/Outlook). Nunca Mail.app.
engage_prospect	Comenta, reacciona, sigue o recomienda a un prospecto para generar confianza
inbox	Navega y lee mensajes de la bandeja de entrada de LinkedIn directamente
backfill_inbox	Procesa mensajes de bandeja de entrada sin responder a través del pipeline de entrada
create_post	Genera y publica una publicación con coincidencia de voz en LinkedIn, X/Twitter o ambos

Gestión de campañas

Herramienta	Qué hace
campaign	Ciclo de vida de campañas — lanzar, pausar, reanudar, archivar, eliminar, detención de emergencia, reintentar fallidos
edit_campaign	Edita el nombre, modo, enlace de reserva o campos de contexto de una campaña
prospect	Gestiona prospectos — omitir, cerrar con resultado, ver conversación o línea de tiempo
import_prospects	Importa prospectos desde datos CSV a una campaña

Información y análisis

Herramienta	Qué hace
analytics	Análisis de campañas — informes, comparaciones y exportaciones
inspect	Resumen de solo lectura de retenciones de operador, replanificaciones de estratega, decisiones de cierre, omisiones de respuesta y trabajos bloqueados
knowledge	Cura la base de conocimiento que fundamenta los mensajes — lista, agrega, elimina, actualiza y busca fuentes. Solo alojado
suggest_next_action	Recomienda la mejor próxima acción, priorizada por impacto
signals	Ve y analiza señales de compra — noticias, compromiso de la empresa, visitas al sitio web, visitantes del perfil
manage_watchlist	Agrega, elimina y lista listas de vigilancia de palabras clave de señales
network	Inteligencia de red — un grupo recíproco de cuentas conectadas de miembros; únete para usarlo

Crecimiento y relaciones

Herramienta	Qué hace
brand_strategy	Analiza y mejora tu marca personal en LinkedIn
profile	Ve y restaura el historial de cambios del perfil de LinkedIn
partner	Rastrea seguimientos con socios comerciales, proveedores e inversores
contacts	Busca, navega y gestiona tu base de contactos global
crm_sync	Sincroniza contactos de campaña y acuerdos con CRM de HubSpot

Automatización y cuenta

Herramienta	Qué hace
scheduler	Gestiona el programador autónomo — estado, encendido/apagado, enviar_desde (nube predeterminada / opt-in local)
product	Solo checkout local de git — parchea este repositorio y/o abre un PR
account	Gestiona cuentas de LinkedIn — listar, cambiar o desconectar
organization	Organizaciones alojadas — listar, cambiar, invitar editor/visor, crear un espacio de trabajo de cliente

---

Características clave

Coincidencia de voz — Analiza tu perfil y publicaciones de LinkedIn para capturar tu estilo de escritura. Cada mensaje suena como si lo hubieras escrito tú.

Generación de ICP — Pipeline impulsado por RAG que rastrea el contexto de la empresa, genera personas compradoras con puntos débiles, miedos, barreras y las mapea a parámetros de búsqueda de LinkedIn.

Programador autónomo — Se ejecuta en segundo plano, respeta horarios laborales y límites de velocidad. En una cuenta alojada, la nube es el remitente predeterminado para cada campaña. Lanzar activa la nube, por lo que la prospección continúa 24/7 con tu laptop cerrada: invitaciones, DMs de apertura, InMail de primer contacto, seguimientos, compromisos, seguimientos, recomendaciones, respaldos de correo electrónico, recargas de prospectos, publicaciones de marca, auto-respuestas, entrada, calentamiento, recolectores de señales e inteligencia de publicaciones. Esta máquina no inicia un motor de programador local para ese trabajo. Mueve toda la cuenta aquí con scheduler(action='send_from', host='local'), que apaga el programador en la nube. Observar aún significa que nadie envía. Las instalaciones directas / autoalojadas envían solo desde esta máquina.

Calentamiento de compromiso — Se involucra automáticamente con publicaciones de prospectos antes de enviar solicitudes de conexión, creando familiaridad.

Límite de velocidad adaptativo — Comienza conservador, aumenta cuando la tasa de aceptación es alta, retrocede cuando baja. Respeta los límites de seguridad de LinkedIn.

Seguimiento de resultados — Marca acuerdos como ganados/perdidos, rastrea tasas de conversión, identifica leads obsoletos, mide el ROI del compromiso.

---

Precios

Plan	Precio	Qué obtienes
Gratis	$0	50 invitaciones/mes, 1 campaña, 2 seguimientos por prospecto, 30 compromisos/mes
Pro	$29/mes	Campañas ilimitadas, 5 seguimientos con horario de varios días, 5 cuentas de LinkedIn, programador en la nube

---

Privacidad

• Llamadas de IA — enrutadas a través del backend de HeyLead o tu propia clave
• MCP en la nube — tus datos se procesan en el servidor pero nunca se comparten con terceros
• Modo local — contactos y mensajes permanecen en tu máquina en una base de datos SQLite local

Usuarios avanzados: pasa tu propia clave de LLM (Gemini/Claude/OpenAI) durante la configuración para usar tu propia IA. Completamente opcional.

---

Modo backend y env

Cuando el cliente MCP habla con un backend de HeyLead (p. ej. heylead-api), el backend usa estas variables de entorno. Los operadores que ejecutan su propio backend deben configurarlas según sea necesario.

Propósito	Ejemplos de variables env
LLM	GEMINI_API_KEY, o OPENAI_API_KEY / ANTHROPIC_API_KEY si usas otros proveedores
Búsqueda / rastreo	SERPER_API_KEY, FIRECRAWL_API_KEY (o similares) para ICP y contexto de empresa
Autenticación / almacenamiento	GOOGLE_* (OAuth), UNIPILE_* (proveedor de LinkedIn), más DB/Redis si se usa
Opcional	Banderas de características, límites de velocidad, registro — ver repositorio del backend

Para configuración completa del backend e implementación, consulta el repositorio heylead-api (o backend) y sus documentos.

---

Dependencias opcionales

La instalación base cubre todas las características principales. Para generación avanzada de ICP:

pip install heylead[icp]    # Embeddings for RAG-powered ICP generation
pip install heylead[crawl]  # Web crawling for company context ingestion
pip install heylead[all]    # Both

---

Solución de problemas

"uvx: comando no encontrado" Instala uv primero: curl -LsSf https://astral.sh/uv/install.sh | sh (o brew install uv en Mac)

"El servidor MCP no se conecta" Reinicia tu editor después de agregar el servidor MCP. En Cursor, verifica Configuración > MCP — el servidor debería mostrar un punto verde.

"La configuración falló" o "LinkedIn no conectado" Asegúrate de haber hecho clic en "Conectar" en la fila de LinkedIn de la página de inicio de sesión (panel: Configuración → Cuentas conectadas) y completado el inicio de sesión de LinkedIn. Luego ejecuta la configuración nuevamente.

¿Necesitas ayuda? Abre un issue.

---

Publicación en PyPI (mantenedores)

Para hacer que HeyLead esté disponible en PyPI (o publicar una nueva versión):

Opción A: Publicar a través de GitHub Release (recomendado)

1. Una vez: Crea una cuenta de PyPI y un token de API. En tu repositorio: Configuración → Secretos y variables → Acciones → agrega el secreto PYPI_TOKEN con el valor del token.
2. Aumenta la versión en pyproject.toml (version = "0.2.4").
3. Haz commit, push, luego crea un GitHub Release (etiqueta p. ej. v0.2.4, título de release opcional). El flujo de trabajo .github/workflows/publish.yml se ejecuta en el release y publica en PyPI.

Opción B: Publicar manualmente

pip install build twine
python -m build          # creates dist/
twine check dist/*       # optional: validate
twine upload dist/*      # prompts for PyPI username + password (use __token__ and your API token)

Después de publicar, cualquiera puede agregarlo con claude mcp add heylead -- uvx heylead (Cursor: comando uvx heylead).

---

Para agentes de IA

HeyLead está diseñado como una herramienta nativa de MCP — construida para agentes de IA, no para humanos que hacen clic en botones.

Instalar como servidor MCP (stdio):

{
  "heylead": {
    "command": "uvx",
    "args": ["heylead"]
  }
}

OpenClaw: Agrega la misma entrada a tu openclaw.json bajo mcp.servers. También disponible en ClawHub — busca "HeyLead".

Inicia sesión en heylead.dev (alojado), o trae tu propia cuenta de Unipile y clave API de LLM (autoalojado). Capacidades: Generación de leads en LinkedIn, automatización de alcance en frío, generación de ICP con perfiles de comprador, mensajería personalizada con tono adaptado, secuencias de goteo multi-toque, clasificación de sentimiento en respuestas, calentamiento de interacción, analítica de campañas y programación autónoma 24/7.

35 herramientas que cubren todo el flujo de trabajo de SDR: descubrimiento de prospectos → alcance → seguimiento → manejo de respuestas → cierre de acuerdos.

Consulta AGENTS.md para la guía completa de integración de agentes.

---

Enlaces

• PyPI
• Registro MCP
• Smithery
• ClawHub (tienda de habilidades de OpenClaw)
• Problemas

Licencia

MIT (código) — ver LICENCIA

La base de conocimiento y las configuraciones de prompts son propietarias.