Cold Leads

npx add-mcp 'https://coldleads.app/api/mcp'

Casos de uso

Receitas práticas para desenvolvedores e criadores de automações. Cada post traz uma configuração, fluxo de trabalho ou script concreto para a API do Cold Leads e informa os limites e custos de créditos aplicáveis. A API exige uma chave secreta do plano Business.

Endereços, IDs e resultados nos exemplos são ilustrativos. example.com é reservado para documentação, portanto uma verificação real desses endereços retorna inválido.

Usar o Cold Leads pelo Cursor, Claude Desktop e Windsurf via MCP

Copiar endereços entre um assistente, um CRM e uma ferramenta de verificação é lento e propenso a erros, e um assistente que recebe pedidos de contatos pode facilmente inventar alguns.

Conecte o servidor MCP do Cold Leads uma única vez. Um assistente pode trabalhar com contatos já existentes no seu espaço de trabalho, importar linhas estruturadas de um arquivo fornecido pelo usuário, ler conversas sincronizadas, manter modelos e rascunhos de campanhas e configurar formulários de captação de leads no site. O envio permanece atrás de confirmação explícita do usuário e das salvaguardas de consentimento, descadastro, DNC, conteúdo e conta do Cold Leads.

O que você obtém: um assistente que trabalha com seus próprios dados de contato, caixa de entrada e rascunhos de divulgação via MCP ou o Node SDK, mantendo cada consulta de site e status de consentimento de divulgação distintos.

Nesta receita

• O que o servidor oferece
• Cursor
• Claude Desktop
• Windsurf (Devin Desktop) e Claude Code
• Prompts que correspondem às ferramentas reais
• Verifique o endpoint hospedado a partir de um terminal
• Limites e custos

Leitura de 5 min

Verificação de e-mail em massa no n8n com Google Sheets

Chamar uma API de verificação uma vez por linha é lento e esbarra nos limites de taxa, enquanto uma API em massa exige um job, um loop de polling e uma forma confiável de mapear os resultados de volta às linhas corretas.

Um único fluxo de trabalho processa até 5.000 linhas que ainda não têm resultado, envia seus endereços únicos como um único job em massa do Cold Leads, faz polling do job a cada 5 segundos, busca os resultados, roteia cada linha por status e grava status, pontuação, motivo e um próximo passo na planilha. Execute novamente para as próximas 5.000.

O que você obtém: quatro colunas preenchidas por linha (verify_status, verify_score, verify_reason, next_step) e um fluxo de trabalho que pode ser executado novamente até que toda a planilha esteja concluída.

Nesta receita

• O que o fluxo de trabalho faz
• Prepare a planilha e as credenciais
• O fluxo de trabalho
• Como funciona o loop de polling
• Roteamento e gravação de volta
• Limites e custos

Leitura de 5 min

Verifique leads no Make.com antes de chegarem a uma campanha do Instantly

Endereços que nunca foram verificados vão direto para uma campanha de envio. Os inválidos geram bounce, e os bounces contam contra as caixas de correio que enviam a campanha.

Coloque uma verificação do Cold Leads entre o gatilho e o Instantly: uma requisição HTTP por lead, um filtro que deixa passar apenas resultados válidos e uma segunda requisição HTTP que adiciona o lead à sua campanha com a API v2 do Instantly.

O que você obtém: um cenário do Make em execução: novo lead, verificação do Cold Leads, filtro, lead adicionado à campanha do Instantly. Leads que falham no filtro param ali ou vão para uma planilha de revisão.

Nesta receita

• Antes de começar
• Construa o cenário
• Escolha o quão rígido é o filtro
• Teste ambas as requisições a partir de um terminal
• Erros e tentativas
• Limites e custos

Leitura de 6 min

Verifique um CSV de 50.000 linhas com Python, asyncio e httpx

Verificar um endereço por requisição é lento e esbarra no limite de taxa. Um loop em massa ingênuo pode abrir mais jobs do que a conta permite, pagar duas vezes após uma falha ou descartar silenciosamente linhas cujos resultados nunca voltaram.

Normalize e deduplique a coluna, envie jobs em massa de até 5.000 endereços, mantenha no máximo cinco abertos, faça polling de cada job até o fim, aguarde os limites de taxa, pare de forma limpa quando os créditos acabarem e salve os IDs dos jobs para que uma segunda execução retome em vez de pagar novamente.

O que você obtém: seu CSV com três novas colunas (verify_status, verify_score, verify_reason) e um arquivo pequeno .jobs.json que torna a execução retomável.

Nesta receita

• Como os endpoints em massa se comportam
• O script
• Execute-o
• O que o script faz quando algo dá errado
• Limites e custos
• Lendo as novas colunas

Leitura de 5 min

Migrando a verificação de e-mail do Hunter ou Apollo para o Cold Leads

O código de verificação está cheio de parâmetros e valores de status específicos do fornecedor. Trocar o endpoint sem mapeá-los muda silenciosamente quais endereços um pipeline envia.

Mapeie cada parâmetro e campo de resposta para seu equivalente no Cold Leads, mantenha o que o Cold Leads não substitui (dados de pessoas, busca de domínio) onde está e use um pequeno adaptador para que o código existente mantenha sua forma.

O que você obtém: um mapeamento campo a campo, um adaptador Python que retorna campos no estilo Hunter a partir do Cold Leads e uma tabela de custos do Cold Leads para 1.000, 10.000 e 50.000 verificações por mês.

Nesta receita

• O que muda e o que permanece
• Email Verifier para POST /api/v1/verify
• Email Finder para POST /api/v1/find
• Um adaptador plug-and-play
• Diferenças de comportamento a planejar
• Limites e custos

Leitura de 5 min

Assinaturas iniciadas por agente, aprovadas por humano

Um agente que precisa de verificação de e-mail nunca deve guardar um cartão ou assinar por conta própria. Enviar o humano para se cadastrar, escolher um plano e copiar uma chave quebra a tarefa, e colar chaves em chats vaza essas informações.

O agente chama um endpoint sem chave e recebe um link do Stripe Checkout para seu proprietário, além de um token secreto de reivindicação. O proprietário revisa o plano e decide. Após o pagamento, o agente coleta a chave da API exatamente uma vez com o token de reivindicação, por polling ou após um callback assinado.

O que você obtém: uma chave de API secreta funcional para a nova conta Business do proprietário, entregue ao agente uma única vez, e um e-mail ao proprietário com um link para abrir o aplicativo web do Cold Leads.

Nesta receita

• O fluxo de uma olhada
• Passo 1: solicite um link de pagamento (sem necessidade de chave)
• Passo 2: o proprietário decide no Stripe
• Passo 3: colete a chave uma única vez
• Opcional: um callback assinado em vez de polling
• Notas de segurança
• Limites e custos

Leitura de 6 min

Como funciona a detecção de accept-all e como ler os resultados do Cold Leads

Alguns servidores de e-mail aceitam mensagens para qualquer endereço em seu domínio, então uma verificação de caixa de correio não consegue distinguir uma pessoa real de um nome inventado. Outros servidores respondem apenas temporariamente, ou não podem ser alcançados, e um rótulo válido simples pode esconder o fato de que a caixa de correio nunca foi verificada.

Entenda o diálogo SMTP que um verificador executa e o que cada resposta significa, depois leia os códigos de status, pontuação e motivo que o Cold Leads retorna, incluindo os casos em que a sondagem da caixa de correio não foi executada.

O que você obtém: uma tabela de decisão que mapeia cada código de motivo do Cold Leads para uma ação, e um script que a aplica a um único endereço.

Nesta receita

• O diálogo SMTP por trás de uma verificação de caixa de correio
• Códigos de resposta e o que eles permitem concluir
• A sondagem de accept-all, greylisting e outros limites
• O que o Cold Leads retorna e quando a sondagem não foi executada
• Uma tabela de decisão e um script que a aplica
• Limites e custos

Leitura de 6 min

Verifique ou encontre endereços de e-mail para novos contatos do HubSpot e Pipedrive

Contatos chegam de formulários, importações e entrada manual com erros de digitação, domínios mortos ou nenhum endereço, e ninguém os verifica até uma campanha sofrer bounce.

Verifique cada contato quando for criado: uma ação de código personalizada em um fluxo de trabalho do HubSpot, ou um pequeno receptor de webhook para o Pipedrive. Um contato com e-mail é verificado; um contato sem e-mail, mas com nome e site da empresa, recebe um endereço sugerido claramente marcado como suposição.

O que você obtém: propriedades de contato no HubSpot ou campos de pessoa no Pipedrive que mostram o status, a pontuação e o motivo do Cold Leads, ou um endereço sugerido com seu método e confiança.

Nesta receita

• Como tudo se encaixa
• HubSpot: uma ação de código personalizada em um fluxo de trabalho de contato
• Pipedrive: um receptor de webhook
• O que gravar de volta e o que fazer com isso
• Limites e custos

Leitura de 3 min

Ferramentas do Cold Leads para agentes CrewAI e LangChain

Um agente que recebe pedidos de dados de contato vai adivinhar, e um endereço adivinhado parece exatamente igual a um real. Sem uma ferramenta de verificação, nem o agente nem a pessoa que lê sua saída conseguem distinguir.

Dê ao agente três ferramentas específicas apoiadas pela API do Cold Leads: buscar no próprio CRM do usuário, verificar um endereço e adivinhar um endereço a partir de um nome e um domínio com um rótulo de método honesto. Erros voltam como dados, então o agente pode reagir em vez de travar.

O que você obtém: um cliente de API compartilhado, classes de ferramentas para CrewAI e para LangChain, e uma crew e um agente mínimos que as utilizam.

Nesta receita

• As três ferramentas
• Um cliente compartilhado
• CrewAI
• LangChain
• Descrições que o modelo pode usar
• Limites e custos

Leitura de 4 min

=VERIFY_EMAIL() e =FIND_EMAIL() no Google Sheets

Exportar uma planilha para uma ferramenta de verificação e colar os resultados de volta é tedioso. Uma função personalizada ingênua chama a API novamente e gasta outro crédito toda vez que o Sheets executa a fórmula novamente.

Duas funções personalizadas chamam a API do Cold Leads com UrlFetchApp, leem a chave das propriedades do script e mantêm cada resposta no cache do script por até seis horas, para que executar a mesma fórmula novamente não gaste outro crédito para a mesma entrada.

O que você obtém: três células de resultado por linha: status, pontuação e motivo de =VERIFY_EMAIL, ou endereço, método e confiança de =FIND_EMAIL.

Nesta receita