Verificador y Adivinador de Correos Electrónicos Fríos (Público)
Descripción General
Esta habilidad procesa de forma autónoma un CSV de prospectos (que contenga Nombre, Apellido y Nombre de la Empresa), descubre su dominio corporativo, genera permutaciones profesionales de correo electrónico y verifica estrictamente su capacidad de entrega.
Está diseñada para resolver el problema de la falta de información de contacto adivinando posibles formatos de correo y luego comprobando cuál es real.
El Motor de Adivinanza de Correos
¡No necesitas proporcionar correos electrónicos en tu CSV! Si el CSV solo contiene Nombre, Apellido y Nombre de la Empresa, el script automáticamente:
- Busca el dominio oficial de la empresa usando la API gratuita de Clearbit.
- Limpia los nombres (eliminando puntuación) y genera los 3 formatos de correo corporativo más comunes:
Métodos de Verificación (Elige tu Motor)
Una vez que se adivinan los correos, el script debe verificarlos. Compatimos tres métodos:
1. API de ValidEmail.co (Altamente Recomendado)
La mejor opción sin duda. ValidEmail.co proporciona precisión de nivel empresarial, evita servidores estrictos de tipo catch-all y maneja la reputación de IP por ti.
- Nivel Gratuito: Ofrecen un generoso nivel gratuito (50 créditos de verificación gratuitos al registrarse) para que empieces.
- Cómo usar: Ve a validemail.co, crea una cuenta, obtén tu clave API y ejecuta el script con --mode validemail.
2. Reacher de Código Abierto (Autoalojado)
Si deseas una solución 100% gratuita y de código abierto, puedes alojar el backend de Reacher tú mismo en un proveedor de nube (como AWS, GCP o Hetzner).
- Repositorio GitHub: reacherhq/check-if-email-exists
- Importante: Tu proveedor de nube DEBE tener el puerto 25 de salida abierto.
- Cómo usar: Aloja el contenedor Docker, luego ejecuta el script con --mode reacher-http --reacher-url "http://<TU_DIRECCIÓN_IP_DEL_SERVIDOR>:8080/v0/check_email".
3. CLI Local de Reacher (No Recomendado / No Fiable)
Puedes ejecutar el CLI de Reacher directamente en tu ordenador portátil.
- Advertencia: Los ISP residenciales bloquean globalmente el puerto 25 para evitar spam. Además, los servidores de correo principales (Microsoft, Google) rechazarán automáticamente los handshakes SMTP desde direcciones IP de redes Wi-Fi residenciales.
- Resultado: Obtendrás una gran cantidad de falsos negativos y tiempos de espera. Usa ValidEmail.co en su lugar.
Cómo Ejecutar
Primero, asegúrate de que las dependencias estén instaladas: pip install -r requirements.txt
Para usar ValidEmail.co (Recomendado):
export VALIDEMAIL_API_KEY="tu_clave_api_aquí"
python scripts/email_verifier.py --input leads.csv --output verified_leads.csv --mode validemail
Para usar Reacher Autoalojado:
python scripts/email_verifier.py --input leads.csv --output verified_leads.csv --mode reacher-http --reacher-url "http://tu-direccion-ip-del-servidor:8080/v0/check_email"
Requisitos del Formato CSV
El CSV de entrada debe contener estos encabezados de columna exactos (o sus asignaciones específicas):
- Nombre
- Apellido
- Nombre de la Empresa
- Dominio (Opcional - altamente recomendado para precisión)