mcpField

sales-anymailfinder

github.com/sales-skills营销与增长42 次安装
代码仓库

关于 sales-anymailfinder

sales-anymailfinder 是为 Anymail Finder 邮箱查找与验证平台提供答疑和操作指导的技能。内容涵盖单条及批量搜索、潜在客户发现、浏览器查找和 API 使用,适用于销售、招聘与增长工作流。

主要功能

  1. 01按人员、公司、职位或 LinkedIn URL 查找邮箱
  2. 02验证邮箱地址
  3. 03通过 CSV、Excel 或 JSON 批量搜索
  4. 04按地理位置发现潜在客户
  5. 05讲解 REST API 和 Chrome Extension 操作

适用场景

  1. 01查找销售潜在客户的联系邮箱
  2. 02验证现有邮箱列表
  3. 03批量处理大型潜在客户名单
  4. 04咨询 API 或浏览器查找方式

安装

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

$npx skills add https://github.com/sales-skills/sales --skill sales-anymailfinder

安装后在 Claude Code 中输入/sales-anymailfinder确认已加载。

包含的文件

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

references/
anymailfinder-api-reference.md
learnings.md
platform-guide.md

详细介绍

Anymail Finder 平台帮助

帮助用户解答 Anymail Finder 平台相关问题——涵盖 Email Finder(按个人、公司、决策者或 LinkedIn URL 查找)、Email Verification、Bulk Email Search、GeoLead Finder 和 Domain Email 操作。Anymail Finder 是一家总部位于伦敦的电子邮件查找与验证工具(AMF Internet Services Limited,成立于 2015 年),为已验证的电子邮件提供 97% 以上的送达保证,提供不设速率限制的 REST API,以及可在工作流中直接查找的 Chrome Extension。

第 1 步——收集背景信息

如果 references/learnings.md 存在,请先阅读,了解积累的知识。

询问用户:

  1. 你需要 Anymail Finder 哪方面的帮助?

    • A)按个人查找 Email Finder——根据名字、姓氏和公司/域名查找已验证的电子邮件(每个有效结果消耗 1 个积分)
    • B)按公司/域名查找 Email Finder——查找某家公司的最多 20 个电子邮件地址(消耗 1 个积分)
    • C)按决策者查找 Email Finder——按角色搜索(ceo、engineering、finance、hr、it、logistics、marketing、operations、buyer、sales),返回姓名、职位、LinkedIn URL 和电子邮件(每个有效结果消耗 2 个积分)
    • D)按 LinkedIn URL 查找 Email Finder——从 LinkedIn 个人资料 URL 提取电子邮件(消耗 1 个积分)
    • E)Email Verifier——验证电子邮件地址,判断其是否有效、有风险或无效(消耗 0.2 个积分)
    • F)Bulk Email Search——通过 JSON 或 CSV/Excel 上传,以异步方式处理最多 100,000 行
    • G)GeoLead Finder——按位置发现潜在客户
    • H)Chrome Extension——在浏览器中从任意网站查找电子邮件
    • I)Domain Email Count/Order/Download——统计、订购并下载某个域名下的所有电子邮件
    • J)API——REST API 设置、端点、身份验证、webhook
    • K)账户/账单——套餐、定价、积分
    • L)其他——请描述具体问题
  2. 你的角色是什么?

    • A)销售/SDR/BDR
    • B)RevOps/销售运营
    • C)开发者/工程师
    • D)增长/营销
    • E)招聘人员/人才招聘
    • F)其他
  3. 你想要达成什么目标?(请描述具体目标或问题)

如果用户的请求已经提供了大部分背景信息,请直接进入相关步骤。 根据合理假设,先尽力回答并明确说明这些假设,然后仅在最后询问最关键的 1~2 个澄清问题——不要在收集完整背景信息之前就拒绝回答。

注意:如果用户需要专门的技能,请简要说明为何该技能更合适,并引导他们使用。

第 2 步——转交或直接回答

如果请求对应某项专门技能,请转交:

  • 跨平台数据增强策略/多工具数据增强 -> /sales-enrich
  • 电子邮件送达率/预热策略(非 Anymail Finder 专属) -> /sales-deliverability
  • 潜在客户名单构建策略 -> /sales-prospect-list
  • 通过中间件将 Anymail Finder 连接到其他工具 -> /sales-integration
  • Hunter.io 专属问题 -> /sales-hunter
  • Apollo 专属问题 -> /sales-apollo
  • Prospeo 专属问题 -> /sales-prospeo
  • Tomba 专属问题 -> /sales-tomba
  • Enrich.so 专属问题 -> /sales-enrichso
  • GetProspect 专属问题 -> /sales-getprospect
  • Minelead 专属问题 -> /sales-minelead
  • Skrapp 专属问题 -> /sales-skrapp

否则,请根据下方的参考资料直接回答平台相关问题。

第 3 步——Anymail Finder 平台参考

阅读 references/platform-guide.md,了解各模块的详细说明、定价、集成和数据模型。

无需再了解平台指南的详细内容——请专注于用户的具体情况。

步骤 4 — 可执行指南

根据用户的具体问题:

  1. 按姓名和公司查找特定人员的电子邮件:

    1. 在请求正文中提供 full_name 和 company_name 或 domain,并在 Authorization: <your-api-key> 请求头中传入 API 密钥,调用 POST /v5.1/search/person.json
    2. 将 HTTP 客户端超时设为至少 180 秒 — 实时搜索可能需要长达 3 分钟,因为系统会检查多个数据源
    3. 检查响应状态:valid 表示电子邮件已验证,送达保证率为 97% 以上;risky 表示未经验证(免费返回,但可靠性较低);not_found 表示无结果(同样免费)
    4. 对于有效结果,可直接使用该电子邮件进行联系 — 97% 以上的保证率意味着退信风险极低
    5. 对于 risky 结果,可单独运行 Email Verifier,或使用其他工具交叉核验后再联系
    6. 在 30 天内重新搜索同一人员是免费的 — 如需再次核验,可放心重试
  2. 按公司内的职位查找决策者电子邮件:

    1. 使用 domain 和 category(可选值:ceo、engineering、finance、hr、it、logistics、marketing、operations、buyer、sales)调用 POST /v5.1/search/decision_maker.json
    2. 请注意,每个有效结果需花费 2 个积分(是人员搜索的两倍)— 处理大型列表时请相应规划预算
    3. 响应中包含姓名、职位、LinkedIn URL 和电子邮件 — 即使不知道具体姓名,也有助于构建客户关系图谱
    4. 如需查找同一公司的多个职位,请按类别分别发起请求
    5. 如果希望在初步搜索之外进行额外验证,可搭配 Email Verifier(0.2 个积分)使用
  3. 为大型潜在客户列表执行批量电子邮件搜索:

    1. 将数据准备为 JSON(最多 100,000 行)或 CSV/Excel 文件
    2. 通过 POST /v5.1/bulk/search.json(JSON)或 POST /v5.1/bulk/upload.json(文件上传)提交
    3. 如果希望在处理完成时收到通知,请包含 x-webhook-url 请求头
    4. 处理为异步进行 — 预计每 5 分钟处理约 1,000 行
    5. 仅在下载结果时扣除积分,提交任务时不扣除 — 你可以先查看输出,再决定是否使用积分
    6. 任务完成后下载结果,并按状态筛选:优先处理 valid 电子邮件,谨慎处理 risky 结果
  4. 验证现有电子邮件列表:

    1. 对于单个电子邮件:使用 email_address 调用 POST /v5.1/verify.json,每个地址花费 0.2 个积分,返回 valid、risky 或 invalid 状态
    2. 在 30 天内重复验证同一电子邮件是免费的
    3. 对于大型列表,请使用批量操作以提高处理效率
    4. 筛选结果:使用 valid 电子邮件进行联系,将 risky 标记为需人工审核,并丢弃 invalid
    5. 请注意,即使邮箱有效,兜底域名也可能返回 risky 状态 — 这些域名会接受所有邮件,无论该地址是否存在

注意事项

基于研究整理,尽力而为——请仔细核对这些内容,尤其是有关积分成本、API 行为和功能限制的条目,这些内容自本文撰写以来可能已有变化。

  1. 决策者搜索的费用是标准人员搜索的 2 倍——每个有效结果需 2 个积分,而标准人员搜索需 1 个积分。 大规模使用基于职位的搜索时,请做好预算。如果知道此人的姓名,使用每次需 1 个积分的标准人员搜索,比每次需 2 个积分的决策者搜索更划算。

  2. 只有有效结果才会计费——风险结果会免费返回,但可靠性较低。 risky 状态表示已找到邮箱,但无法完成验证。这些邮箱仍可能有效,但退信风险较高。不要将风险结果视为与有效结果等同——对于风险地址,请考虑额外验证或采用更谨慎的发送方式。

  3. 实时人员搜索最长可能需要 180 秒——请相应设置 HTTP 超时时间。 许多 HTTP 客户端的默认超时时间为 30 秒,这会导致请求过早失败。请为所有搜索端点设置至少 180 秒的超时时间。如果你正在构建面向用户的集成,请显示加载状态,并考虑使用 Webhook 进行异步通知,而不是阻塞 UI。

  4. 批量搜索在下载时扣除积分,而不是在创建任务时扣除。 这意味着你可以提交大型任务、查看结果摘要,然后决定下载(并付费)或丢弃结果。不过,在下载前不要认为任务是“免费”的——提交时就应规划好积分成本,否则尝试下载时可能会发现积分不足,令人措手不及。

  5. GeoLead Finder 文档不完整——请做好试验的准备。 GeoLead Finder 端点(Create、Get Info、Download Results)已经存在,但公开文档有限。在进行大规模地理区域潜在客户搜索之前,请先使用小规模请求,了解输入参数、响应格式和积分成本。

  6. 即使邮箱有效,Catch-all 域名也可能返回风险状态。 Catch-all(或 accept-all)域名配置为接受发往该域名下任意地址的邮件,因此无法验证特定邮箱是否存在。由于无法确认邮件是否能送达特定地址,Anymail Finder 会对此类邮箱返回 risky。如果目标公司使用 Catch-all 域名,你将持续收到风险结果——这是预期行为,并非数据质量问题。

  7. 没有速率限制不代表高流量请求会立即得到响应——请求会进入队列。 Anymail Finder 没有明确的速率限制,系统也会自动扩展,但请求量较大时,请求会进入队列,而不是同时处理。响应时间会随请求量增加而相应延长。对于大规模操作,请使用批量端点,而不要单独发出数千次 API 调用。

  8. Chrome Extension 需要在同一浏览器中登录 anymailfinder.com。 如果你已退出 Anymail Finder 网站,扩展程序将无法使用。如果扩展程序无法找到邮箱,请检查你的会话是否已过期。扣除积分的方式与使用 API 相同。

  9. 积分累积上限为套餐额度的 2 倍。 未使用的积分会结转至下个月,但最多只能累积至月度额度的 2 倍。例如,Standard 套餐(每月 1,000 个积分)最多可累积 2,000 个积分。超过上限的积分将被作废。如果你持续未用完套餐额度,不妨考虑降级,而不要以为积分可以无限期累积。

  • 持续改进:如果你发现此处未涵盖的内容,请将其附加到 references/learnings.md,并注明今天的日期。

步骤 5 — 相关技能

  • /sales-enrich — 跨平台数据丰富策略(多工具数据丰富工作流、瀑布式数据丰富)
  • /sales-deliverability — 电子邮件送达率与验证策略(SPF/DKIM/DMARC、预热、收件箱投递)
  • /sales-prospect-list — 潜在客户名单构建策略与最佳实践
  • /sales-integration — 将 Anymail Finder 连接到 CRM、自动化工具或其他平台
  • /sales-hunter — Hunter.io 平台帮助(类似的域名电子邮件搜索与验证)
  • /sales-apollo — Apollo 平台帮助(类似的电子邮件查找器,支持销售互动)
  • /sales-prospeo — Prospeo 平台帮助(类似的电子邮件查找器,专注于 LinkedIn)
  • /sales-tomba — Tomba 平台帮助(类似的电子邮件查找器与验证器)
  • /sales-enrichso — Enrich.so 平台帮助(B2B 数据丰富 API,包含 LinkedIn 和公司数据)
  • /sales-getprospect — GetProspect 平台帮助(类似的电子邮件查找器与潜在客户开发工具)
  • /sales-minelead — Minelead 平台帮助(类似的电子邮件查找器、验证器与潜在客户开发工具)
  • /sales-skrapp — Skrapp 平台帮助(类似的电子邮件查找器,集成 LinkedIn)
  • /sales-do — 不确定该使用哪项技能?路由器会根据任意销售目标匹配合适的技能。安装:npx skills add sales-skills/sales --skill sales-do

示例

示例 1:按职位查找决策者的电子邮件

用户说:“我需要联系 acme.com 的营销负责人,但不知道对方的姓名。” 技能执行:

  1. 使用 Decision Maker 搜索:通过 POST /v5.1/search/decision_maker.json,传入 domain: "acme.com" 和 category: "marketing" — 返回姓名、职位、LinkedIn URL 和电子邮件
  2. 检查响应状态:valid 表示该电子邮件已验证,并提供 97% 以上的送达保证
  3. 说明费用:有效的决策者搜索结果需 2 个积分(标准人员搜索需 1 个积分)
  4. 如果结果为 risky,建议通过 POST /v5.1/verify.json(0.2 个积分)单独验证,或交叉核对 LinkedIn URL,以确认此人仍担任该职位
  5. 向用户提供联系人的姓名、职位、LinkedIn 个人资料和已验证的电子邮件,以便联系 结果:用户获得了 acme.com 一位经过验证的营销决策者联系人的信息,包括可供参考的 LinkedIn 个人资料,可立即开展个性化联系
示例 2:通过 Webhook 通知进行批量电子邮件搜索

用户说:“我有一份包含 5,000 名潜在客户的 CSV,里面有姓名和公司。我需要批量查找他们的电子邮件。” 技能执行:

  1. 通过 POST /v5.1/bulk/upload.json 上传 CSV,并设置 Authorization: <api-key> 和 x-webhook-url: https://myapp.com/webhook 标头
  2. 说明异步处理方式:每 5 分钟处理约 1,000 行,因此 5,000 行大约需要 25 分钟
  3. 说明只有在用户下载结果时才会扣除积分 — 用户可以先查看任务摘要
  4. Webhook 触发(或用户轮询状态)后,即可下载结果
  5. 建议筛选下载的结果:优先联系 valid 电子邮件,对 risky 结果谨慎处理,舍弃 not_found 结果
  6. 估算积分费用:如果所有结果都有效,最多需 5,000 个积分(每次人员搜索 1 个积分);但 risky 和未找到的结果不收费 — 实际费用取决于命中率 结果:用户获得了一份经过批量处理的名单,其中包含 5,000 名潜在客户的已验证电子邮件,并带有清晰的状态标识,且只对有效结果扣除积分
示例 3:验证并清理现有邮件列表

用户说:“我有在一场贸易展上收集的 200 个电子邮件地址。添加到 CRM 前该如何验证?” 技能执行以下操作:

  1. 单个验证:使用 POST /v5.1/verify.json,并传入 email_address——返回 valid、risky 或 invalid(每个地址消耗 0.2 个点数)
  2. 对于 200 个电子邮件地址,建议采用批量方式以提高效率——通过 POST /v5.1/bulk/search.json 以 JSON 格式提交,或上传 CSV 文件
  3. 估算点数成本:验证需要 200 x 0.2 = 40 个点数——即使是 Starter 套餐(每月 50 个点数)也足够
  4. 解释状态含义:valid = 可安全添加到 CRM 并发送邮件(送达率保证为 97% 以上),risky = 可能有效,但未经验证(常见于全收邮件域名),invalid = 不要发送邮件
  5. 建议进行分类:立即将 valid 添加到 CRM,将 risky 留待人工审核或二次验证,丢弃 invalid
  6. 说明这些邮件地址中的任何一个在 30 天内重新验证均免费——因此可以放心在营销活动启动前再次检查 结果:用户获得了一份经过清理和分类的邮件列表,200 个地址均已验证,耗费 40 个点数,可直接导入 CRM,且已排除退信风险

故障排除

搜索人员时,已知联系人却返回 not_found

症状:使用正确的姓名和域名调用 POST /v5.1/search/person.json,却返回 not_found,尽管你知道此人在该公司工作。 原因:此人可能未被收录在 Anymail Finder 的数据库中;提供的域名可能不是该公司的主要电子邮件域名;或者此人使用了不同的姓名形式(例如,“Bill”与“William”,婚前姓名与婚后姓名)。 解决方案:尝试姓名的其他拼写或形式。尝试使用公司的主域名,而不是子域名或区域域名。如果你有此人的 LinkedIn 个人资料,请尝试改用 LinkedIn URL 搜索(POST /v5.1/search/linkedin.json)——这会使用不同的查询机制。如果公司规模较小,或此人刚刚担任该职位,他们可能尚未被收录。

批量任务耗时超出预期

症状:一个包含 10,000 行的批量搜索任务已处理超过一小时,但仍未收到完成通知。 原因:正常情况下,处理速度约为每 5 分钟 1,000 行,但平台负载较高时,处理速度可能会降低。系统会自动扩展,但不会即时完成——高峰时段的大型任务可能需要更长时间。 解决方案:通过 API 检查任务状态,不要只依赖 Webhook 通知。如果使用 Webhook,请确认 Webhook URL 可访问,并且会返回 200 响应。对于有时限要求的任务,请在非高峰时段提交。如果任务似乎卡住,请向 Anymail Finder 支持团队提供任务 ID 并联系他们。

预期为 valid 的邮件却返回 risky 状态

症状:搜索电子邮件时,某些联系人的状态返回 risky,但你以前成功给这些公司的其他人发送过邮件。 原因:该公司可能使用全收邮件域名——这类域名会接受发往任何地址的邮件,因此无法验证某个特定邮箱是否存在。由于无法通过其 97% 以上的保证确认邮件能否送达特定地址,Anymail Finder 会返回 risky。 解决方案:在同一域名下验证一个明显虚假的地址(例如 [email protected]),以检查该域名是否为全收域名——如果该地址也返回 risky,则说明此域名为全收域名。对于全收域名,可将 risky 结果视为很可能有效但无法验证。考虑先发送风险较低的初始邮件,以确认邮件可以送达,再将其加入完整的外联序列。请记住,risky 结果免费——不会为此扣除点数。

评论

支持 Markdown