HeyLead

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

HeyLead

Seu representante de vendas com IA. Um comando para encher seu funil.

HeyLead é um SDR autônomo de LinkedIn nativo de MCP que roda dentro do Cursor, Claude Code ou qualquer editor compatível com MCP. Faça login na web, depois converse com sua IA e diga "encontre leads para mim".

---

Começando

MCP (Model Context Protocol) permite que assistentes de IA usem ferramentas externas. HeyLead dá à sua IA a capacidade de fazer prospecção no LinkedIn por você.

Você precisa de: Cursor ou Claude Code — qualquer editor de IA compatível com MCP.

Passo 1: Instale o HeyLead

HeyLead roda localmente via stdio. Você precisa de uv:

Claude Code:

claude mcp add heylead -- uvx heylead

Cursor: Settings > MCP > "Add new MCP server" > Name: heylead, Command: uvx heylead

Qualquer cliente MCP:

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

Atualize com uvx --refresh heylead.

Passo 2: Configure sua conta

Opção A — Hospedado (mais fácil): faça o quiz de 90 segundos ou entre em heylead.dev/dashboard/login. As personas do seu quiz viram uma campanha de rascunho. Conecte o LinkedIn em Settings → Connected accounts, depois lance pelo dashboard — ou copie sua mensagem de configuração de Settings → Integrations → Chat client para o chat da sua IA. Nada é enviado antes de você lançar. Usuários hospedados compartilham um diretório profissional; campanhas e caixas de entrada permanecem privadas.

Opção B — Auto-hospedado: rode tudo contra suas próprias contas. Você precisa de duas coisas primeiro:

1. Uma conta Unipile — é isso que fala com o LinkedIn. Cadastre-se em unipile.com, depois coloque o DSN e a chave de API da página Access Tokens em ~/.heylead/config.json como unipile_api_url e unipile_api_key.
2. Uma chave de API de LLM — chamadas de IA são cobradas para você. Uma chave Gemini gratuita é suficiente para começar.

Depois, abra o chat da sua IA e diga:

"Configure meu perfil HeyLead com esta chave Gemini: SUA_CHAVE"

Você receberá um link de autenticação do LinkedIn. Abra-o, conecte o LinkedIn, depois diga "finalizar configuração". HeyLead busca seu perfil e analisa seu estilo de escrita.

Passo 3: Encontre leads

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

---

Como Funciona

1. Defina seu ICP — "Gere um ICP para fundadores de SaaS de IA" → personas com tecnologia RAG com dores, barreiras e segmentação no LinkedIn
2. Crie uma campanha — "Encontre CTOs de fintech" → pesquisa no LinkedIn, pontua prospects por adequação
3. Aqueça prospects — Interage com as postagens deles (comentários, curtidas) antes de entrar em contato
4. Envie convites personalizados — Mensagens com tom de voz que soam como você, não como um robô
5. Acompanhe automaticamente — Sequências de múltiplos toques após as conexões serem aceitas
6. Lide com respostas — Detecta sentimento, avança leads positivos para reuniões, responde perguntas
7. Acompanhe resultados — Rastreamento de ganhos/perdas/opt-out com análises de conversão

Modelo de segurança: campanhas são criadas como rascunhos e só começam quando você as lança explicitamente. Cada envio passa por limites de taxa, verificações de horário comercial e uma proteção de conexão de 1º grau antes de sair. Lançar também é o que comissiona o envio em nuvem 24/7 — no modo observe nada é comissionado e nada é enviado, de nenhuma das máquinas.

---

Ferramentas

HeyLead dá à sua IA 35 ferramentas:

Fluxo de Trabalho Principal

Ferramenta	O que faz
setup_profile	Conecta o LinkedIn e analisa seu estilo de escrita em uma assinatura de voz
generate_icp	Gera um Perfil de Cliente Ideal rico com personas de comprador
icp	Pré-visualiza quais perfis do LinkedIn um ICP salvo corresponde, sem criar uma campanha
profile_signals	Compila uma solicitação de segmentação (vínculos de país, interesses) em consultas de recall do LinkedIn e pontuação de evidências de perfil
create_campaign	Cria uma campanha de prospecção (como rascunho) a partir de uma descrição em linguagem natural
generate_and_send	Gera uma mensagem personalizada do LinkedIn e a envia
check_replies	Verifica novas respostas em campanhas, classifica sentimento, destaca leads quentes
book_meeting	Coloca uma chamada acordada no seu Google Calendar e envia um convite ao prospect
show_status	Seu painel — campanhas, estatísticas, leads quentes, saúde da conta. Links para a página correspondente do heylead.dev/dashboard e, em contas hospedadas, anexa um cartão de resumo

Prospecção e Engajamento

Ferramenta	O que faz
send_message	Envia acompanhamentos e respostas para prospects
send_email	Envia e-mail via uma caixa de correio Unipile conectada (Gmail/Outlook). Nunca Mail.app.
engage_prospect	Comenta, reage, segue ou recomenda um prospect para construir confiança
inbox	Navega e lê mensagens da caixa de entrada do LinkedIn diretamente
backfill_inbox	Processa mensagens não respondidas da caixa de entrada pelo pipeline de entrada
create_post	Gera e publica uma postagem com tom de voz no LinkedIn, X/Twitter ou ambos

Gerenciamento de Campanhas

Ferramenta	O que faz
campaign	Ciclo de vida da campanha — lançar, pausar, retomar, arquivar, excluir, parada de emergência, tentar novamente falhas
edit_campaign	Edita nome, modo, link de agendamento ou campos de contexto de uma campanha
prospect	Gerencia prospects — pular, fechar com resultado, ver conversa ou linha do tempo
import_prospects	Importa prospects de dados CSV para uma campanha

Insights e Análises

Ferramenta	O que faz
analytics	Análises de campanha — relatórios, comparações e exportações
inspect	Resumo somente leitura de retenções de operador, replanejamentos de estrategista, decisões de fechador, pulos de resposta e trabalhos bloqueados
knowledge	Curadoria da base de conhecimento que fundamenta mensagens — lista, adiciona, remove, atualiza e pesquisa fontes. Somente hospedado
suggest_next_action	Recomenda a melhor próxima ação, priorizada por impacto
signals	Visualiza e analisa sinais de compra — notícias, engajamento da empresa, visitas ao site, visualizadores de perfil
manage_watchlist	Adiciona, remove e lista listas de palavras-chave de sinais
network	Inteligência de rede — um pool recíproco de contas conectadas de membros; participe para usá-lo

Crescimento e Relacionamentos

Ferramenta	O que faz
brand_strategy	Analisa e melhora sua marca pessoal no LinkedIn
profile	Visualiza e restaura o histórico de mudanças do perfil do LinkedIn
partner	Acompanha follow-ups com parceiros de negócios, fornecedores e investidores
contacts	Pesquisa, navega e gerencia sua base global de contatos
crm_sync	Sincroniza contatos de campanha e negócios para o CRM HubSpot

Automação e Conta

Ferramenta	O que faz
scheduler	Gerencia o agendador autônomo — status, ligar/desligar, enviar_de (padrão nuvem / opt-in local)
product	Somente checkout git local — aplique patch neste repositório e/ou abra um PR
account	Gerencia contas do LinkedIn — listar, alternar ou desconectar
organization	Organizações hospedadas — listar, alternar, convidar editor/visualizador, criar um espaço de trabalho de cliente

---

Principais Recursos

Correspondência de Voz — Analisa seu perfil e postagens do LinkedIn para capturar seu estilo de escrita. Cada mensagem parece que foi escrita por você.

Geração de ICP — Pipeline com tecnologia RAG que rastreia contexto da empresa, gera personas de comprador com dores, medos, barreiras e as mapeia para parâmetros de pesquisa do LinkedIn.

Agendador Autônomo — Roda em segundo plano, respeita horários comerciais e limites de taxa. Em uma conta hospedada, a nuvem é o remetente padrão para cada campanha. Lançar comissiona a nuvem, então a prospecção continua 24/7 com seu laptop fechado: convites, DMs de abertura, InMail de primeiro contato, follow-ups, engajamentos, seguidores, recomendações, fallbacks de e-mail, recargas de prospects, postagens de marca, respostas automáticas, entrada, aquecimento, coletores de sinais e pós-inteligência. Esta máquina não inicia um mecanismo de agendador local para esse trabalho. Mova toda a conta para cá com scheduler(action='send_from', host='local'), que desliga o agendador em nuvem. Observar ainda significa que ninguém envia. Instalações diretas / auto-hospedadas enviam somente desta máquina.

Aquecimento por Engajamento — Engaja automaticamente com postagens de prospects antes de enviar solicitações de conexão, construindo familiaridade.

Limitação de Taxa Adaptativa — Começa conservador, aumenta quando a taxa de aceitação é alta, recua quando cai. Respeita os limites de segurança do LinkedIn.

Rastreamento de Resultados — Marque negócios como ganhos/perdidos, rastreie taxas de conversão, identifique leads obsoletos, meça o ROI de engajamento.

---

Preços

Plano	Preço	O que você recebe
Grátis	$0	Até 2 follow-ups por prospect
Pro	$29 por conta de LinkedIn conectada por mês	Até 5 follow-ups por prospect

Os limites de convite seguem a conta do LinkedIn (grátis, Premium ou Sales Navigator), não o plano HeyLead. Instalações gratuitas auto-hospedadas têm cotas mensais: 50 convites, 20 mensagens, 30 engajamentos, 1 campanha ativa.

---

Privacidade

• Chamadas de IA — roteadas pelo backend do HeyLead ou sua própria chave
• MCP em nuvem — seus dados são processados no servidor, mas nunca compartilhados com terceiros
• Modo local — contatos e mensagens permanecem na sua máquina em um banco de dados SQLite local

Usuários avançados: Passe sua própria chave de LLM (Gemini/Claude/OpenAI) durante a configuração para usar sua própria IA. Completamente opcional.

---

Modo backend e env

Quando o cliente MCP fala com um backend HeyLead (ex.: heylead-api), o backend usa estas variáveis de ambiente. Operadores que rodam seu próprio backend devem configurá-las conforme necessário.

Propósito	Exemplo de env vars
LLM	GEMINI_API_KEY, ou OPENAI_API_KEY / ANTHROPIC_API_KEY se usar outros provedores
Pesquisa / rastreamento	SERPER_API_KEY, FIRECRAWL_API_KEY (ou similar) para contexto de ICP e empresa
Autenticação / armazenamento	GOOGLE_* (OAuth), UNIPILE_* (provedor LinkedIn), além de DB/Redis se usado
Opcional	Feature flags, limites de taxa, logging — veja o repositório do backend

Para configuração completa do backend e implantação, veja o repositório heylead-api (ou backend) e sua documentação.

---

Dependências Opcionais

A instalação base cobre todos os recursos principais. Para geração avançada 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

---

Solução de Problemas

"uvx: command not found" Instale uv primeiro: curl -LsSf https://astral.sh/uv/install.sh | sh (ou brew install uv no Mac)

"MCP server not connecting" Reinicie seu editor após adicionar o servidor MCP. No Cursor, verifique Settings > MCP — o servidor deve mostrar um ponto verde.

"Setup failed" ou "LinkedIn not connected" Certifique-se de que você clicou em "Connect" na linha do LinkedIn da página de login (painel: Settings → Connected accounts) e completou o login do LinkedIn. Depois, execute a configuração novamente.

Precisa de ajuda? Abra uma issue.

---

Publicação no PyPI (mantenedores)

Para disponibilizar o HeyLead no PyPI (ou publicar uma nova versão):

Opção A: Publicar via GitHub Release (recomendado)

1. Uma vez: Crie uma conta PyPI e um token de API. No seu repositório: Settings → Secrets and variables → Actions → adicione o segredo PYPI_TOKEN com o valor do token.
2. Aumente a versão em pyproject.toml (version = "0.2.4").
3. Commit, push, depois crie uma GitHub Release (tag ex.: v0.2.4, título da release opcional). O workflow .github/workflows/publish.yml roda na release e publica no PyPI.

Opção 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)

Após publicar, qualquer pessoa pode adicioná-lo com claude mcp add heylead -- uvx heylead (Cursor: comando uvx heylead).

---

Para Agentes de IA

HeyLead é projetado como uma ferramenta nativa de MCP — construída para agentes de IA, não para humanos clicando em botões.

Instale como servidor MCP (stdio):

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

OpenClaw: Adicione a mesma entrada ao seu openclaw.json sob mcp.servers. Também disponível no ClawHub — pesquise "HeyLead".

Entre em heylead.dev (hospedado), ou traga sua própria conta Unipile e chave de API de LLM (auto-hospedado). Recursos: Geração de leads no LinkedIn, automação de outreach a frio, geração de ICP com buyer personas, mensagens personalizadas com correspondência de voz, sequências de drip com múltiplos toques, classificação de sentimento de respostas, aquecimento de engajamento, análises de campanha e agendamento autônomo 24/7.

35 ferramentas cobrindo todo o fluxo de trabalho do SDR: descoberta de prospects → outreach → follow-up → tratamento de respostas → fechamento de negócios.

Consulte AGENTS.md para o guia completo de integração do agente.

---

Links

• PyPI
• MCP Registry
• Smithery
• ClawHub (loja de skills do OpenClaw)
• Issues

Licença

MIT (código) — consulte LICENSE

A base de conhecimento e as configurações de prompts são proprietárias.