Waterfall Enrichment 是一个用于外联获客场景的联系人信息补全（enrichment）技能，核心思路是按顺序运行多个数据源，并在遇到第一个“已验证”结果时停止。它的目标不只是覆盖率，而是在已知的单联系人成本下获得覆盖率——没有价格的级联只是一串供应商名称。
用途与入口 该技能区分多种输入情形，入口不同，下游流程完全不同：
- Entry A：已有姓名 + 公司域名，这是最常见的情况，邮箱查找器正好接受这类输入。
- Entry A2：只有域名、还没有联系人。先找人，再对没有验证邮箱的人跑邮箱级联。
- Entry B：只有 LinkedIn 个人主页 URL。邮箱查找器接受的是姓名和域名，而不是 URL，因此需要两个阶段：先把主页解析为姓名 + 公司 + 域名，再跑邮箱级联。对 URL 输入做单阶段级联几乎返回零结果，这属于流程搭建问题，而非覆盖率问题。
主要能力
-
找人（Entry A2）：以域名为键的人员搜索节点优于主页爬虫。爬虫每家公司要爬几十个页面、需要会话 Cookie、经常失效，而且返回的仍是没有邮箱的主页信息；人员搜索节点则附带联系方式，十个域名约一分钟返回。每次调用只处理一个域名——一次传十个域名并设结果上限二十，并不会得到每家公司两人，而是由供应商随意分配。建议每个账户取两个人：经济买家（小公司常是创始人）与会被问“这是真的吗”的技术或职能审批人。当两人同时返回时，可视为对人物画像工作的实时校验。约十分之一的公司可能返回空结果，偶尔有人返回不可用邮箱，这属于覆盖率问题而非查询错误；可放宽一次查询（去掉地区筛选、放宽职位、增加一个资历层级）确认，仍为空则说明供应商无数据，转入 LinkedIn-URL 级联或人工队列。
-
Pass 0 输入审计：在花钱之前先检查客户交来的数据。真实案例中，131 个地址里只有 27 个是本公司域名，76 个是外部域名（个人、合作方、代理机构），19 个根本不是地址（其中一条写着“四月再写”）。需检查：域名与账户不匹配的地址、本应工作邮箱却填了免费邮箱、地址列中的非地址文本、已带验证地址的行（不要重复购买）。数据先修正，再做补全。
-
级联流程：
- 阶段一 主页解析（仅 Entry B）：先试廉价解析器（约 0.09 credits，失败率高但便宜），再用全价人员补全（约 0.37 credits，命中率高）作为后备。
- 阶段二 邮箱查找：主查找器（LeadMagic 或同类，约 0.37–0.4 credits，覆盖广且最便宜）→ 次查找器（Findymail 或同类，约 0.45–0.6 credits，补主查找器遗漏）→ 自有工具中的联系人卡片（Apollo 导出、CRM，免费，付费前先查）→ 域名模式 + 验证（免费，仅在模式已知且在 2 个以上已知地址上确认过时使用）。
- 阶段三 验证：每个结果都跑验证器（ZeroBounce 或同类，约 0.09–0.3 credits），包括免费来源的结果。
- 预算上限：完整两阶段路径每人约 1.4 credits，开始前先报价。
规则
- 遇到第一个已验证结果即停止；仅在未命中或“有风险/未知”时进入下一个来源。
- 不要因为首选源通常获胜就删掉后备源。首次实跑中，廉价解析器失败、付费解析器命中；随后主查找器失败、次查找器命中。
- 付费源之前先查免费源。
- 不要把研究或网页浏览代理放进联系人级联——它们无法可靠地从公开网络抓取邮箱和电话，且每次尝试成本高于查找器。
- 只接受“有效”，拒绝“有风险”“未知”；catch-all 是单独一类，不等于拒绝。
- catch-all 域名可在较低置信度下发送：先打标记，小批量试发，观察该域名退信率后再扩大。
- 绝不向未验证地址发送。5% 的无效率就足以损害发件人声誉，且损害比活动本身更持久。
- 优先给顶层队列花钱，不要为永远不会触达的行付费。
预期与输出 干净数据、域名正确的情况下，50–70% 验证率属正常；高于此值要检查是否真的跑了验证器。低于 50%，问题通常出在输入（姓名格式错误、域名错误、用了控股公司而非运营公司域名、联系人确实没有工作邮箱）。次查找器通常比仅用主查找器多 10–20 个百分点，这正是其价值所在。 输出报告包含：列表名、日期、处理数、入口类型；输入审计（自带地址行数、本公司域名/外部域名/非地址数量、已跳过验证行数）；结果（已验证、catch-all、未找到及占比）；来源明细（各来源找到数与花费 credits，免费来源单独列）；验证（有效数、移除的风险/无效数）；成本（总 credits、每个已验证联系人成本）；最终干净列表数。每个已验证联系人的成本才是关键指标，总花费除以处理行数会美化糟糕的运行。
其他说明与要求 每个地址都要归属到找到它的来源，以便日后投递效果变差时判断该淘汰哪个供应商。对已全部失败的行走重跑很少产生结果，应修正输入后再跑，而非按计划定期重跑。info@、hello@、sales@ 等角色地址不是联系人，应放单独列，绝不进入个人地址活动。所需集成：带人员搜索节点的工作流运行器（如 Freckle over Apollo 或同类，用于 Entry A2，需认证并固定组织 id）、邮箱查找器（LeadMagic、Findymail 或同类，必需，自有账户）、验证器（ZeroBounce 或同类，必需，自有账户）；主页解析器用于 Entry B，属于同一运行器的一部分。示例实现见 assets/find-people.yaml，并附有调用与角色筛选说明。