cold-email-verifier

Cold Email Verifier and Guesser（公开技能）用于解决潜客名单中缺少邮箱联系方式的问题：它会读取包含名字、姓氏和公司名称的 CSV，自动发现企业域名，生成常见的企业邮箱排列组合，并严格验证这些邮箱是否可投递。

一、邮箱推测引擎 无需在 CSV 中提供邮箱。如果 CSV 只包含 First Name、Last Name 和 Company Name，脚本会自动执行以下步骤：

1. 使用免费的 Clearbit API 查询公司的官方域名。
2. 清洗姓名（去除标点符号），并生成三种最常见的企业邮箱格式：

• first@domain.com
• first.last@domain.com
• firstlast@domain.com

二、验证方式（可选引擎） 推测出邮箱后，脚本需要对它们进行验证，支持三种方式：

1. ValidEmail.co API（强烈推荐） 官方描述为最佳选项。ValidEmail.co 提供企业级准确度，可绕过严格的 catch-all 服务器，并代为处理 IP 信誉问题。 免费额度：注册即提供 50 个免费验证额度。 使用方法：前往 validemail.co 创建账号，获取 API 密钥，然后以 --mode validemail 运行脚本。

2. Reacher 开源方案（自托管） 如果需要 100% 免费的开源方案，可以在云服务商（如 AWS、GCP 或 Hetzner）上自行托管 Reacher 后端。 GitHub 仓库：reacherhq/check-if-email-exists 重要限制：云服务商必须开放出站 25 端口。 使用方法：托管 Docker 容器后，以 --mode reacher-http --reacher-url "http://<YOUR_SERVER_IP>:8080/v0/check_email" 运行脚本。

3. Reacher 本地 CLI（不推荐 / 不可靠） 可以直接在笔记本电脑上运行 Reacher CLI。 注意：全球住宅 ISP 为防垃圾邮件会封锁 25 端口；此外，Microsoft、Google 等主要邮件服务器会自动拒绝来自住宅 Wi-Fi IP 地址的 SMTP 握手。 结果：会产生大量误判和超时。建议改用 ValidEmail.co。

三、执行方式 先安装依赖：pip install -r requirements.txt

使用 ValidEmail.co（推荐）：

export VALIDEMAIL_API_KEY="your_api_key_here"
python scripts/email_verifier.py --input leads.csv --output verified_leads.csv --mode validemail

使用自托管 Reacher：

python scripts/email_verifier.py --input leads.csv --output verified_leads.csv --mode reacher-http --reacher-url "http://your-server-ip:8080/v0/check_email"

四、CSV 格式要求 输入 CSV 必须包含以下确切列名（或其特定映射）：

• First Name
• Last Name
• Company Name
• Domain（可选，但强烈建议提供以提高准确度）

五、适用场景与限制 适用场景：需要验证冷邮件、补全潜客名单，或在只有姓名与公司信息时推测企业邮箱。 限制：邮箱推测依赖 Clearbit API 查询域名；验证效果取决于所选引擎，本地 Reacher CLI 因住宅网络端口与 IP 信誉限制而不可靠；自托管 Reacher 需自行准备具备出站 25 端口的服务器。关于具体价格、准确率数据及其他未在资料中说明的功能，暂未提供。