关于 cold-email-verifier
cold-email-verifier 用于处理潜在客户 CSV:查询公司域名、生成可能的企业邮箱地址并验证可投递性。它支持通过 ValidEmail.co 或 Reacher 进行验证。
主要功能
- 01通过 Clearbit 查询公司域名
- 02生成三种邮箱格式
- 03使用 ValidEmail.co API 验证
- 04使用自托管 Reacher 后端验证
- 05读取并输出 CSV 文件
适用场景
- 01根据姓名和公司查找邮箱
- 02联系前验证猜测的邮箱地址
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ varnan-tech/ opendirectory --skill cold-email-verifier安装后在 Claude Code 中输入/cold-email-verifier确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.env.exampleREADME.mdrequirements.txtscripts/email_verifier.py详细介绍
冷邮件验证与猜测器(公开版)
概览
此技能可自动处理包含潜在客户信息的 CSV(含名、姓和公司名称),查找其企业域名,生成专业的电子邮件地址组合,并严格验证其可送达性。
它旨在解决缺少联系信息的问题:猜测常见的电子邮件地址格式,然后检查哪一个有效。
电子邮件地址猜测引擎
无需在 CSV 中提供电子邮件地址!如果 CSV 只包含名、姓和公司名称,脚本将自动:
- 使用免费的 Clearbit API 查找公司的官方网站域名。
- 清理姓名(移除标点符号),并生成最常见的 3 种企业电子邮件地址格式:
验证方法(选择你的引擎)
猜测出电子邮件地址后,脚本必须对其进行验证。我们支持三种方法:
1. ValidEmail.co API(强烈推荐)
绝佳选择。 ValidEmail.co 提供企业级准确性,可绕过严格的全收件地址服务器,并为你处理 IP 信誉。
- 免费套餐: 注册后即可获得 50 个免费验证额度,助你快速上手!
- 使用方法: 前往 validemail.co,创建账户并获取 API 密钥,然后使用 --mode validemail 运行脚本。
2. Reacher 开源版(自托管)
如果你想要完全免费的开源解决方案,可以在云服务提供商(如 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(推荐):
ash export VALIDEMAIL_API_KEY="your_api_key_here" python scripts/email_verifier.py --input leads.csv --output verified_leads.csv --mode validemail
使用自托管的 Reacher:
ash 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(可选,但强烈建议提供,以提高准确性)