关于 contact-enrichment
面向营销工作流的联系人丰富 Skill,通过 ColdIQ 端点查找公司 LinkedIn 页面、邮箱和电话号码。它按成本从低到高尝试邮箱来源,跳过已丰富的联系人,并在联系前验证邮箱。
主要功能
- 01解析公司 LinkedIn 网址
- 02查找工作及个人邮箱
- 03按低成本优先执行邮箱瀑布流程
- 04发送前验证邮箱
- 05查找电话号码
- 06跳过已丰富的联系人
适用场景
- 01外联前丰富联系人列表
- 02邮件营销前验证邮箱
- 03为指定联系人查找电话号码
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ cold-iq/ coldiq-marketplace-skills --skill contact-enrichment安装后在 Claude Code 中输入/contact-enrichment确认已加载。
附带文件resources/async-job-pattern.mdresources/credit-optimization.md
详细介绍
联系人信息补全
为一组联系人查找 LinkedIn 网址、工作/个人邮箱和电话号码——按价格从低到高使用 ColdIQ 端点,并跳过已补全信息的联系人。经典的多提供商邮箱瀑布流(Prospeo → Findymail → FullEnrich,然后验证)完全通过 ColdIQ 市场端点运行,因此只需一个密钥和统一额度,无需管理多个提供商账户。
ColdIQ 市场端点
| 任务 | 方法 | 路径 | 额度 | 端点 ID | 备注 |
|---|---|---|---|---|---|
| 根据域名查找公司 LinkedIn 网址 | POST | /v1/limadata/find/company-linkedin | 1 | limadata.find.company_linkedin | 替代 Linkup /enrich/linkedin |
| 工作邮箱(姓名 + 域名) | POST | /v1/limadata/find/work-email | 1 | limadata.find.work_email | 未找到时免费 |
| 工作邮箱(LinkedIn 网址) | POST | /v1/limadata/find/work-email-linkedin | 3 | limadata.find.work_email_linkedin | 后备方案 |
| 个人邮箱 | POST | /v1/limadata/find/personal-email | 5 | limadata.find.personal_email | 最后手段 |
| 电话号码 | POST | /v1/limadata/find/phone | 10 | limadata.find.phone | 未找到时免费 |
| 验证邮箱(退信检查) | POST | /v1/findymail/verify | 1 | findymail.verify | 替代 Debounce |
| 通过 Prospeo 查找邮箱(瀑布流步骤) | POST | /v1/prospeo/enrich-person | 未知 | prospeo.enrich_person | 瀑布流第一步 |
| 通过 Findymail 查找邮箱(LinkedIn) | POST | /v1/findymail/search/business-profile | 1 | findymail.search.business_profile | 瀑布流步骤 |
| 通过 FullEnrich 查找邮箱(批量) | POST | /v1/fullenrich/contact/enrich/bulk | 每条结果 | fullenrich.contact.enrich_bulk | 终极方案,异步 |
| 补全人员信息(资料) | POST | /v1/limadata/enrich/person | 1–5 | limadata.enrich.person | 完整资料 |
第 1 层——公司 LinkedIn 网址
给定公司域名,先解析其 LinkedIn 公司主页(后续步骤需要这些网址)。
→ POST /v1/limadata/find/company-linkedin · 1 cr · limadata.find.company_linkedin
第 2 层——邮箱瀑布流(按价格从低到高,找到即停止)
- 尝试使用姓名 + 公司域名。
→ POST
/v1/limadata/find/work-email· 1 cr ·limadata.find.work_email - 如果没有结果/缺少域名,则改用 LinkedIn 网址查找。
→ POST
/v1/limadata/find/work-email-linkedin· 3 cr ·limadata.find.work_email_linkedin - 使用同一个 LinkedIn 网址,尝试第二家服务提供商。
→ POST
/v1/findymail/search/business-profile· 1 cr ·findymail.search.business_profile - 使用提供商级信息补全作为后备方案。
→ POST
/v1/prospeo/enrich-person· ? cr ·prospeo.enrich_person(未经验证) - 对仍缺失的信息采用终极方案(批量、异步——参见
resources/async-job-pattern.md)。
→ POST
/v1/fullenrich/contact/enrich/bulk· 每条结果 ·fullenrich.contact.enrich_bulk - 只有在确实无法获取工作邮箱时,才查找个人邮箱。
→ POST
/v1/limadata/find/personal-email· 5 cr ·limadata.find.personal_email
根据联系人质量,典型的累计命中率为 85–95%。
第 3 层——发送前验证
未经验证的邮箱会损害发件人声誉。验证找到的每个地址。
→ POST /v1/findymail/verify · 1 cr · findymail.verify
| 状态 | 操作 |
|---|---|
| 有效 / 可投递 | 可以安全发送 |
| 有风险 / 全部接受 | 谨慎发送(全收型域名) |
| 无效 / 不可投递 | 切勿发送 |
| 未知 | 使用其他提供商重试 |
电话号码
→ POST /v1/limadata/find/phone · 10 cr · limadata.find.phone(未找到时免费;使用 LinkedIn 网址或姓名 + 公司)
成本优化
参见 resources/credit-optimization.md。关键规则: 先去重(list-dedup),优先使用成本最低的输入,找到结果即停止, 先用 50–100 行数据测试,再处理完整列表;仅将有效/有风险的邮箱导出到营销活动中。
检查清单
- 在进行任何补充数据操作前,先对联系人去重
- 解析公司 LinkedIn URL(第 1 层)
- 按成本从低到高运行电子邮件瀑布流程,命中后停止(第 2 层)
- 验证所有找到的电子邮件(第 3 层)
- 先在 50–100 行上测试;如果命中率低于 50%,请检查数据质量
- 仅将已验证/有风险的电子邮件导出到营销活动中(绝不导出无效邮件)