mcpField

sales-enrichso

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

关于 sales-enrichso

面向销售、RevOps、工程和营销团队的 Enrich.so 技能,介绍这款 B2B 数据丰富 API 平台,并指导查询、批量处理和基于 API 的数据丰富工作流。

主要功能

  1. 01人员与公司数据丰富指导
  2. 02邮箱和电话查找流程
  3. 03批量处理与 Webhook 指引
  4. 04API 集成说明
  5. 05邮箱验证指导

适用场景

  1. 01通过邮箱丰富 CRM 联系人资料
  2. 02查找并验证决策者邮箱
  3. 03根据访客 IP 识别公司
  4. 04构建相似公司潜客名单

安装

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

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

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

包含的文件

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

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

详细介绍

Enrich.so 平台帮助

帮助用户解答 Enrich.so 平台相关问题,涵盖反向邮箱查找和 LinkedIn 个人资料丰富、邮箱/电话查找、公司数据、相似公司搜索、员工搜索、IP 转公司、职位列表、批量丰富以及邮箱验证。Enrich.so 是一个实时 B2B 数据丰富 API 平台,每次查询可提供 50 多个数据点,并采用按成功结果计费的积分模式(仅对已验证的结果付费)。

第 1 步 — 收集背景信息

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

询问用户:

  1. 你需要 Enrich.so 哪方面的帮助?

    • A) 反向邮箱查找 — 根据邮箱地址查找 LinkedIn 个人资料、职位、公司和 50 多个数据点
    • B) LinkedIn 个人资料丰富 — 根据 LinkedIn URL 获取完整的个人资料数据(教育经历、职位、技能、联系信息、人脉信息)
    • C) 邮箱查找 — 根据姓名 + 公司,或通过 LinkedIn,查找经过验证的企业邮箱
    • D) 电话号码查找 — 从个人资料中查找电话号码、邮箱转电话、手机号码查找
    • E) 公司数据查询 — 根据公司名称、域名或 LinkedIn URL 查询公司详情(行业、规模、收入、技术栈、社交资料)
    • F) 公司融资与流量 — 融资轮次、投资者、金额、网站流量估算
    • G) 搜索相似公司 — 根据 LinkedIn URL 查找相似公司,并可使用筛选条件(地点、员工规模)
    • H) 搜索公司员工 — 根据公司和职位查找决策者及其详细个人资料
    • I) IP 转公司 — 根据 IP 地址识别公司(包括远程办公人员)
    • J) 职位列表 — 实时搜索公司职位发布信息
    • K) 批量丰富 — 通过 CSV 上传、JSON 数组或 CSV URL 进行批量处理,并支持 Webhook 回调
    • L) 邮箱验证 / 一次性邮箱检查 / 反向邮箱补全
    • M) 集成 / API — REST API、Zapier、n8n、Make、Webhook
    • N) 账户 / 账单 — 套餐、定价、积分
    • O) 其他 — 请描述你的需求
  2. 你的职位是什么?

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

如果用户的请求已经提供了大部分背景信息,请直接进入相关步骤。 基于合理假设(并明确说明)尽力先给出答案,然后只在最后提出 1–2 个最关键的澄清问题——不要因为需要收集完整背景信息而延迟回复。

注意:如果用户需要专门技能,请简要说明为什么该技能更合适,并将其引导至相应技能。

第 2 步 — 转接或直接回答

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

  • 跨平台数据丰富策略 / 多工具数据丰富 -> /sales-enrich
  • 邮件送达率 / 验证策略(非 Enrich.so 专属)-> /sales-deliverability
  • 潜在客户名单构建策略 -> /sales-prospect-list
  • 通过中间件将 Enrich.so 连接到其他工具 -> /sales-integration
  • Apollo.io 专属问题 -> /sales-apollo
  • ZoomInfo 专属问题 -> /sales-zoominfo
  • Clearbit 专属问题 -> /sales-clearbit

否则,请根据下方参考内容直接解答平台相关问题。

第 3 步 — Enrich.so 平台参考

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

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

第 4 步 — 可执行的指导

根据用户的具体问题:

  1. 使用 LinkedIn 数据丰富电子邮件联系人列表:

    1. 将列表整理为包含 email 列的 CSV
    2. 使用批量丰富端点:POST /v1/api/bulk-enrichment,类型设为 person,并上传 CSV(或传入 JSON 数组或 CSV URL)
    3. 在请求正文中加入 webhookUrl,以便在处理完成时接收回调 — 无需轮询
    4. 获取结果:使用提交调用返回的 uid,调用 GET /v1/api/bulk-enrichment-results?uid=<uid>
    5. 对于每个匹配的电子邮件,结果包含 LinkedIn URL、职位、公司、所在地以及 50 多个数据点
    6. 将丰富后的数据导入 CRM — 将字段映射到 CRM 的联系人属性
    7. 只有成功丰富的记录会消耗额度 — 未匹配的电子邮件不收费
  2. 查找目标客户中的决策者邮箱:

    1. 从目标公司的 LinkedIn URL 或域名开始
    2. 使用 Search Company Employees 按职位查找人员:筛选职位名称,例如 “VP Sales”、“Head of Engineering”、“CTO”
    3. 对于每位匹配的员工,使用 LinkedIn to Email 获取其工作邮箱地址
    4. 在联系之前,使用 Email Validation 端点验证每个邮箱 — 检查是否为全收域名以及邮箱是否无效
    5. 也可以使用 Phone Number Finder 添加电话联系渠道,以支持多渠道序列
    6. 对于大型客户列表,使用类型为 find-email 的 Bulk Enrichment 进行批量处理
  3. 通过 IP to Company 识别网站访客身份:

    1. 从 Web 服务器日志或分析平台获取访客 IP 地址
    2. 对每个 IP 地址调用 GET /v1/api/ip-to-company
    3. Enrich.so 会返回关联公司的名称、域名、行业、规模和 LinkedIn URL — 远程工作者也适用
    4. 根据 ICP 标准(行业、规模、收入)匹配返回的公司,以确定后续跟进的优先级
    5. 使用 Company Data Lookup 获取高优先级匹配公司的完整企业概况信息
    6. 使用 Search Company Employees 查找每家已识别公司的合适联系人
    7. 使用 Zapier(IP to Company 触发器)或你选择的集成平台自动化整个流程
  4. 构建相似公司列表:

    1. 找出最佳客户的 LinkedIn 公司 URL
    2. 对每个 URL 调用 POST /v1/api/similar-companies — 也可以按所在地和员工规模筛选,以匹配 ICP
    3. 结果包含相关性评分 — 优先选择评分高于所设阈值的公司
    4. 使用 Company Data Lookup 丰富排名靠前的匹配结果,获取完整企业概况信息(行业、收入、技术栈)
    5. 使用 Search Company Employees 查找每个新目标客户中的决策者
    6. 使用 Email Finder 或 LinkedIn to Email 获取联系人详细信息,以便联系
  5. 设置 Enrich.so API 集成:

    1. 在 enrich.so 注册,并从控制面板获取 API 令牌
    2. 在所有请求中设置 Authorization 标头:Authorization: Bearer <your-token>
    3. 使用单次查询进行测试:GET https://api.enrich.so/v1/api/[email protected]
    4. 处理响应:检查 HTTP 状态码 — 200 表示成功,404 表示无匹配项(不消耗额度),401 表示身份验证错误,429 表示超出速率限制
    5. 对于批量工作流,使用异步批量丰富端点,而不要循环调用单条查询 — 效率更高,也能避免触发速率限制
    6. 为批量任务设置 Webhook 回调,以免轮询:在批量请求正文中加入 webhookUrl
    7. 在 Enrich.so 控制面板中监控额度使用情况 — 设置提醒,避免额度意外耗尽

注意事项

基于调研整理,仅供参考——请核查以下内容,尤其是涉及套餐限制功能和集成注意事项的项目,它们可能已经过时。

  1. 按成功结果计费意味着查询未命中时不收费,但不同端点的积分成本各不相同——制定预算前,请查看定价页面了解各端点的积分成本。 人员信息补全查询的积分成本可能与公司查询或电话号码查找不同。请根据所用端点的组合规划积分分配,而不只是根据查询总数。
  2. 批量信息补全是异步的——你必须轮询结果或使用 Webhook。 提交批量任务后会立即返回 uid,但响应中不会包含结果。你需要轮询 GET /v1/api/bulk-enrichment-results?uid=<uid>,直到任务完成;或者在请求中加入 webhookUrl,以接收通知。大型数据集的任务可能需要几分钟到几小时,具体取决于数据量。
  3. LinkedIn 个人资料信息补全取决于 LinkedIn URL 格式——请使用标准个人资料 URL。 请传入完整的 https://www.linkedin.com/in/username 格式。缩短版 URL、Sales Navigator URL 或带查询参数的 URL 可能无法正确解析。调用 API 前,请移除跟踪参数。
  4. IP 转公司信息的准确性不一——共享 IP、VPN 和云服务提供商无法解析到具体公司。 对于企业 IP 范围,以及将远程员工的 ISP 映射到公司的场景,该端点效果最佳;但使用 VPN、共享办公空间或基于云的浏览方式的访客,可能会返回不准确或空结果。匹配率可能低于 100%,请验证优先级较高的匹配结果。
  5. Zapier 集成仅支持特定触发器和操作(反向邮箱查询、IP 转公司信息)——对于其他端点,请直接使用 REST API,或使用自定义 Zapier Webhook 步骤。 并非所有 Enrich.so 端点都有原生 Zapier 触发器或操作。对于 Similar Companies、Employee Search 或 Bulk Enrichment 等端点,你需要使用 Zapier 的 Webhook 操作,或者通过带有 HTTP 请求节点的 n8n/Make 进行连接。
  • 持续改进:如果你发现此处未涵盖的内容,请将其附上今天的日期,添加到 references/learnings.md。

第 5 步 — 相关技能

  • /sales-enrich — 跨平台数据补全策略(多工具信息补全工作流、瀑布式信息补全)
  • /sales-deliverability — 邮件送达率和验证策略(SPF/DKIM/DMARC、预热、收件箱投放)
  • /sales-prospect-list — 潜在客户名单构建策略和最佳实践
  • /sales-integration — 将 Enrich.so 连接到 CRM、自动化工具或其他平台
  • /sales-do — 不确定该使用哪项技能?路由器会将任何销售目标匹配到合适的技能。安装:npx skills add sales-skills/sales --skill sales-do

示例

示例 1:使用 LinkedIn 和公司数据补全 CRM 联系人信息

用户说:“我的 CRM 中有 500 个联系人,只有他们的电子邮件地址。我想为每个人添加 LinkedIn 个人资料、职位和公司信息。” 技能执行:

  1. 建议将联系人导出为包含 email 列的 CSV 文件
  2. 使用 Bulk Enrichment(POST /v1/api/bulk-enrichment),设置类型为 person 并上传 CSV——说明异步工作流和 Webhook 回调选项
  3. 任务完成后,使用 GET /v1/api/bulk-enrichment-results?uid=<uid> 获取结果
  4. 将返回的字段(linkedin_url、job_title、company_name、company_domain、location)映射到用户 CRM 联系人的属性
  5. 说明只有成功匹配的联系人会消耗积分——未匹配的电子邮件不收费
  6. 建议对结果中的唯一公司域名运行 Company Data Lookup,以在账户层级添加公司信息(行业、规模、收入) 结果:用户的 500 个联系人均已补全 LinkedIn 个人资料、职位和公司详情,可用于细分和个性化外联
示例 2:查找并验证目标客户公司的决策者邮箱

用户说:“我需要为外呼营销活动查找 20 家目标公司的工程副总裁邮箱。” 技能执行:

  1. 向用户收集 20 家公司的 LinkedIn URL 或域名
  2. 对每家公司使用 Search Company Employees,并筛选职位包含 “VP” 且部门为 “Engineering” 的员工
  3. 对每位匹配的员工,使用 LinkedIn to Email 查找其工作邮箱
  4. 使用 Email Validation 端点验证每个邮箱——标记全收邮件域名、无效邮箱和基于角色的邮箱地址
  5. 可选:使用 Phone Number Finder 添加直拨号码,以便开展多渠道外联
  6. 提供一份包含邮箱、电话、LinkedIn URL 和职位的 20 位已验证决策者联系人清单 结果:用户获得一份经过验证和丰富的工程副总裁联系人清单,可用于个性化外呼序列
示例 3:识别高意向网站访客并转交给销售团队

用户说:“我们每月有 10K 名网站访客,但不知道他们是谁。Enrich.so 能帮我们识别访问网站的公司吗?” 技能执行:

  1. 说明 IP to Company 端点——从 Web 服务日志或分析工具中获取访客 IP,然后调用 API 识别每个 IP 所属的公司
  2. 搭建自动化工作流:访客 IP -> IP to Company API -> 按 ICP 标准筛选(行业、员工人数、营收)-> 通知销售团队
  3. 建议使用 Zapier 的 IP to Company 集成实现无代码配置,或使用自定义 webhook 进行实时处理
  4. 对于匹配的公司,串联 Company Data Lookup 获取完整的公司概况数据,并使用 Search Company Employees 找到合适的买家角色
  5. 提醒用户,VPN 用户、共享 IP 和云服务提供商的 IP 无法解析——根据流量构成,预计公司匹配率为 20-40%
  6. 建议结合职位发布信号(招聘产品所支持相关岗位的公司)来确定外联优先级 结果:用户获得一条自动化访客识别流程,可发现访问其网站的高意向公司,并将丰富后的潜在客户信息转交给销售团队

故障排查

批量丰富任务卡住或返回不完整结果

症状:通过 POST /v1/api/bulk-enrichment 提交的批量丰富任务返回了 uid,但轮询 GET /v1/api/bulk-enrichment-results 后发现任务在很长时间后仍处于处理中,或结果缺少部分行。 原因:大型批量任务需要时间处理——由于采用异步方式,结果不会立即返回。如果输入文件存在格式问题(CSV 格式错误、缺少必需列、编码问题),或者某些行包含无法处理的无效数据,也可能导致结果不完整。 解决方案:首先,检查输入文件是否有效——CSV 应采用 UTF-8 编码,并包含与丰富类型相对应的正确列标题(例如,人员丰富使用 email,LinkedIn 丰富使用 linkedin_url)。如果任务仍在处理中,请继续轮询或等待 webhook 回调——大型任务(10K+ 行)可能需要 30 分钟到数小时。如果结果缺少部分行,请检查任务状态中的错误计数——部分行可能单独处理失败。将失败的行放入单独批次重新提交。如果任务似乎永久卡住,请联系 Enrich.so 支持团队并提供任务 uid。

有效邮箱的反向查询未返回结果

症状:调用反向邮箱查询端点时,已知有效的商务邮箱没有匹配结果(HTTP 404 或结果为空),尽管此人拥有 LinkedIn 个人资料。 原因:Enrich.so 的反向邮箱查询依赖邮箱与 LinkedIn 个人资料或其他已索引数据源相关联。如果此人在 LinkedIn 上使用了不同的邮箱、个人资料设为私密,或邮箱与个人资料的映射尚未编入索引,则不会返回匹配结果。免费邮箱服务提供商(Gmail、Yahoo)的匹配率低于商务域名。 解决方案:确认邮箱拼写正确,且是此人的主要商务邮箱。如果使用的是免费邮箱,请改用此人的工作邮箱尝试——商务域名的匹配率明显更高。或者,如果你知道此人的姓名和公司,可使用 Email Finder 端点查找其商务邮箱,然后用该邮箱进行反向查询。如果你有其 LinkedIn URL,可直接使用 LinkedIn Profile Enrichment,而不必进行反向查询。

API 返回 401 Unauthorized,尽管令牌有效

症状:API 请求返回 HTTP 401,但控制面板中显示的 API 令牌似乎正确。 原因:常见原因包括:复制令牌时带有前导或尾随空格;Authorization 标头格式错误(必须为 Bearer <token>,不能是 Basic 或只有令牌);令牌已重新生成,但仍在使用旧令牌;或者账户因账单问题而被暂停。 解决方案:从 Enrich.so 控制面板重新复制令牌,注意是否带有尾随空格或换行符。确认标头格式准确为 Authorization: Bearer <token>,且 "Bearer" 后只有一个空格。检查使用的是当前有效令牌(重新生成令牌会使旧令牌失效)。确认账户状态正常——查看控制面板中是否有账单提醒或账户暂停通知。使用简单的 cURL 命令进行测试,以确定问题出在代码还是令牌本身:curl -H "Authorization: Bearer <token>" "https://api.enrich.so/v1/api/[email protected]"。

评论

支持 Markdown