Verificador e Adivinhador de E-mails Frios (Público)
Visão Geral
Esta skill processa autonomamente um CSV de leads (contendo Nome, Sobrenome e Nome da Empresa), descobre o domínio corporativo da empresa, gera permutações profissionais de e-mail e verifica rigorosamente a entregabilidade dos mesmos.
Ela foi projetada para resolver o problema de falta de informações de contato, adivinhando ângulos comuns de e-mail e verificando qual deles é real.
O Mecanismo de Adivinhação de E-mail
Você não precisa fornecer e-mails no seu CSV! Se o CSV contiver apenas Nome, Sobrenome e Nome da Empresa, o script automaticamente:
- Consulta o domínio oficial da empresa usando a API gratuita do Clearbit.
- Limpa os nomes (removendo pontuação) e gera os 3 formatos de e-mail corporativo mais comuns:
Métodos de Verificação (Escolha seu Mecanismo)
Uma vez que os e-mails são adivinhados, o script deve verificá-los. Oferecemos três métodos:
1. API ValidEmail.co (Altamente Recomendado)
A melhor opção absoluta. ValidEmail.co fornece precisão de nível empresarial, contorna servidores catch-all rigorosos e gerencia a reputação de IP para você.
- Camada Gratuita: Eles oferecem uma generosa camada gratuita (50 créditos de verificação gratuitos no cadastro) para você começar!
- Como usar: Acesse validemail.co, crie uma conta, obtenha sua chave de API e execute o script com --mode validemail.
2. Reacher Open Source (Auto-hospedado)
Se você quiser uma solução 100% gratuita e de código aberto, pode hospedar o backend do Reacher em um provedor de nuvem (como AWS, GCP ou Hetzner).
- Repositório GitHub: reacherhq/check-if-email-exists
- Importante: Seu provedor de nuvem DEVE ter a Porta 25 de saída aberta.
- Como usar: Hospede o contêiner docker, depois execute o script usando --mode reacher-http --reacher-url "http://<SEU_IP_DO_SERVIDOR>:8080/v0/check_email".
3. Reacher CLI Local (Não Recomendado / Não Confiável)
Você pode executar o CLI do Reacher diretamente no seu laptop.
- Aviso: Provedores de ISP residenciais bloqueiam globalmente a Porta 25 para prevenir spam. Além disso, servidores de e-mail importantes (Microsoft, Google) rejeitarão automaticamente handshakes SMTP de endereços IP de Wi-Fi residenciais.
- Resultado: Você terá uma quantidade massiva de falsos negativos e timeouts. Use ValidEmail.co.
Como Executar
Primeiro, garanta que as dependências estão instaladas: pip install -r requirements.txt
Para usar ValidEmail.co (Recomendado):
export VALIDEMAIL_API_KEY="sua_chave_de_api_aqui"
python scripts/email_verifier.py --input leads.csv --output verified_leads.csv --mode validemail
Para usar Reacher Auto-hospedado:
python scripts/email_verifier.py --input leads.csv --output verified_leads.csv --mode reacher-http --reacher-url "http://seu-ip-do-servidor:8080/v0/check_email"
Requisitos de Formato CSV
O CSV de entrada deve conter exatamente estes cabeçalhos de coluna (ou seus mapeamentos específicos):
- Nome
- Sobrenome
- Nome da Empresa
- Domínio (Opcional - altamente recomendado para precisão)