mcpField
C
cold-email-verifier

cold-email-verifier

github.com/varnan-tech营销与增长68752 次安装2 周前更新
代码仓库

关于 cold-email-verifier

cold-email-verifier 用于处理潜在客户 CSV:查询公司域名、生成可能的企业邮箱地址并验证可投递性。它支持通过 ValidEmail.co 或 Reacher 进行验证。

主要功能

  1. 01通过 Clearbit 查询公司域名
  2. 02生成三种邮箱格式
  3. 03使用 ValidEmail.co API 验证
  4. 04使用自托管 Reacher 后端验证
  5. 05读取并输出 CSV 文件

适用场景

  1. 01根据姓名和公司查找邮箱
  2. 02联系前验证猜测的邮箱地址

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/varnan-tech/opendirectory --skill cold-email-verifier

安装后在 Claude Code 中输入/cold-email-verifier确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

.env.example
README.md
requirements.txt
scripts/
email_verifier.py

详细介绍

冷邮件验证与猜测器(公开版)

概览

此技能可自动处理包含潜在客户信息的 CSV(含名、姓和公司名称),查找其企业域名,生成专业的电子邮件地址组合,并严格验证其可送达性。

它旨在解决缺少联系信息的问题:猜测常见的电子邮件地址格式,然后检查哪一个有效。

电子邮件地址猜测引擎

无需在 CSV 中提供电子邮件地址!如果 CSV 只包含名、姓和公司名称,脚本将自动:

  1. 使用免费的 Clearbit API 查找公司的官方网站域名。
  2. 清理姓名(移除标点符号),并生成最常见的 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(可选,但强烈建议提供,以提高准确性)

评论

支持 Markdown