mcpField
D
data-enrichment

data-enrichment

github.com/merit-systems数据与数据库340 次安装34 周前更新
代码仓库

关于 data-enrichment

data-enrichment 是通过 x402scan MCP 工具调用 enrichx402.com 数据补充 API 的 Skill,面向需要查询和补全人员、公司资料的工作流。它包含端点发现、搜索、单条及批量补充指引。

主要功能

  1. 01人员与公司资料补充
  2. 02人员及公司搜索
  3. 03LinkedIn 资料抓取
  4. 04联系人信息恢复
  5. 05最多 10 条记录批处理
  6. 06端点发现与字段筛选

适用场景

  1. 01按邮箱或 LinkedIn 资料补全人员信息
  2. 02按域名获取公司资料
  3. 03按职位、地点等条件搜索对象
  4. 04批量处理人员或公司记录

MCP 相关

通过 x402scan MCP 工具访问 enrichx402.com API,使用发现、检查架构和 fetch 工具调用端点。

安装

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

$npx skills add https://github.com/merit-systems/x402scan-skills --skill data-enrichment

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

附带文件rules/getting-started.md

详细介绍

使用 x402 API 增强数据

请停下——调用任何 API 前请先阅读。 enrichx402.com 端点与各提供商的原生 API 并不相同。所有路径均采用以下格式:https://enrichx402.com/api/{provider}/{action}。你必须:

  1. 从下方的快速参考表中复制准确的 URL,或
  2. 运行 x402.discover_api_endpoints(url="https://enrichx402.com") 获取正确路径

猜测路径会导致失败,并返回 405 错误(路径错误)或 404 错误(缺少 /api/ 前缀)。

使用 x402scan MCP 工具访问 enrichx402.com 上的数据增强 API。

设置

安装和钱包设置请参阅 rules/getting-started.md。

快速参考

任务端点价格适用场景
增强个人信息https://enrichx402.com/api/apollo/people-enrich$0.0495电子邮件/LinkedIn -> 完整个人资料
增强公司信息https://enrichx402.com/api/apollo/org-enrich$0.0495域名 -> 公司数据
搜索个人https://enrichx402.com/api/apollo/people-search$0.02按条件查找个人
搜索公司https://enrichx402.com/api/apollo/org-search$0.02按条件查找公司
抓取 LinkedInhttps://enrichx402.com/api/clado/linkedin-scrape$0.04完整 LinkedIn 个人资料
补全联系信息https://enrichx402.com/api/clado/contacts-enrich$0.20查找缺失的电子邮件/电话
批量处理个人https://enrichx402.com/api/apollo/people-enrich/bulk$0.495一次最多处理 10 位个人
批量处理公司https://enrichx402.com/api/apollo/org-enrich/bulk$0.495一次最多处理 10 家公司

工作流

标准数据增强
  1. (可选)检查余额:x402.get_wallet_info
  2. 发现端点(首次获取前必须执行): x402.discover_api_endpoints(url="https://enrichx402.com")
  3. 检查端点架构:x402.check_endpoint_schema(url="..."),以验证参数和价格
  4. 使用 x402.fetch 调用端点,使用从发现结果或上方快速参考表中获取的准确 URL
  5. 解析并展示结果
x402.fetch(
  url="https://enrichx402.com/api/apollo/people-enrich",
  method="POST",
  body={"email": "[email protected]"}
)

个人信息增强

使用任何可用标识符增强个人信息:

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-enrich",
  method="POST",
  body={
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Doe",
    "organization_name": "Acme Inc",
    "domain": "company.com",
    "linkedin_url": "https://linkedin.com/in/johndoe"
  }
)

输入选项(可任意组合):

  • email - 电子邮件地址(最可靠)
  • linkedin_url - LinkedIn 个人资料 URL
  • first_name + last_name - 姓名(与域名/组织信息搭配时效果更好)
  • organization_name 或 domain - 有助于匹配正确的个人

返回内容:姓名、职位、公司、就业经历、所在地、社交资料、电话号码。

公司信息增强

通过域名增强公司信息:

x402.fetch(
  url="https://enrichx402.com/api/apollo/org-enrich",
  method="POST",
  body={
    "domain": "stripe.com"
  }
)

返回内容:公司名称、行业、员工人数、收入估算、融资信息、所用技术、社交链接。

搜索个人

搜索符合条件的个人:

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-search",
  method="POST",
  body={
    "q_keywords": "software engineer",
    "person_titles": ["CTO", "VP Engineering"],
    "organization_domains": ["google.com", "meta.com"],
    "person_locations": ["San Francisco, CA"]
  }
)

搜索筛选条件:

  • q_keywords - 搜索关键词
  • person_titles - 职位筛选条件
  • organization_domains - 公司域名
  • person_locations - 地点筛选条件
  • person_seniorities - 职级

搜索公司

搜索符合条件的公司:

x402.fetch(
  url="https://enrichx402.com/api/apollo/org-search",
  method="POST",
  body={
    "q_keywords": "fintech",
    "organization_locations": ["New York, NY"],
    "organization_num_employees_ranges": ["51-200", "201-500"]
  }
)

LinkedIn 抓取(Clado)

获取完整的 LinkedIn 个人资料数据:

x402.fetch(
  url="https://enrichx402.com/api/clado/linkedin-scrape",
  method="POST",
  body={
    "linkedin_url": "https://linkedin.com/in/johndoe"
  }
)

返回内容:工作经历、教育背景、技能、认证、推荐、联系人数量。

补全联系信息(Clado)

查找缺失的电子邮件或电话号码:

x402.fetch(
  url="https://enrichx402.com/api/clado/contacts-enrich",
  method="POST",
  body={
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "email": "[email protected]"
  }
)

返回内容:经过验证的电子邮件地址和电话号码,以及置信度评分。

批量操作

一次请求最多处理 10 条记录:

x402.fetch(
  url="https://enrichx402.com/api/apollo/people-enrich/bulk",
  method="POST",
  body={
    "people": [
      { "email": "[email protected]" },
      { "email": "[email protected]" },
      { "linkedin_url": "https://linkedin.com/in/person3" }
    ]
  }
)

公司信息:

x402.fetch(
  url="https://enrichx402.com/api/apollo/org-enrich/bulk",
  method="POST",
  body={
    "organizations": [
      { "domain": "company1.com" },
      { "domain": "company2.com" }
    ]
  }
)

优化成本

字段筛选

排除不需要的字段以降低成本:

body={
  "email": "[email protected]",
  "excludeFields": ["employment_history", "photos", "phone_numbers"]
}

常见的排除字段:

  • employment_history - 过往工作(通常数据量较大)
  • photos - 个人资料图片
  • phone_numbers - 仅需要电子邮件时
  • social_profiles - 不需要社交链接时
批量处理与单条处理
  • 单条处理:每条记录 $0.0495
  • 批量处理(10 条):总计 $0.495 = 每条记录 $0.0495

批量处理的单条记录价格相同,但处理多条记录时速度更快。

先搜索,再补充信息

先使用搜索端点($0.02)找到合适的记录,再补充信息($0.0495):

  1. 搜索候选项:/api/apollo/people-search
  2. 查看结果,选出匹配项
  3. 仅补充所需匹配项的信息

并行调用

补充多个互不相关的记录时,请并行调用:

# These can run simultaneously since they're independent
x402.fetch(url=".../people-enrich", body={"email": "[email protected]"})
x402.fetch(url=".../people-enrich", body={"email": "[email protected]"})

或者使用批量端点,以获得最高效率。

处理缺失数据

如果查询未能返回你要查找的数据,请重新查看可用 API 列表。

很多时候,如果 apollo 缺少数据,clado 就会有,反之亦然。

如果仍然无法找到,请使用内置的 WebSearch 和 WebFetch 工具查找更多信息,例如公司域名或 LinkedIn URL,然后利用这些数据进行更有针对性的查询。

评论

支持 Markdown