data-enrichment

使用 x402 API 丰富数据

使用 agentcash CLI 访问 stableenrich.dev 上的丰富数据 API。

设置

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

强制工作流

调用 stableenrich.dev 之前：

1. npx agentcash@latest discover https://stableenrich.dev
2. npx agentcash@latest check <endpoint-url> — 确认请求字段和价格
3. 使用步骤 2 中的架构运行 npx agentcash@latest fetch

始终使用 npx agentcash@latest fetch 调用 stableenrich.dev 端点；切勿使用 curl 或 WebFetch。

切勿猜测字段名称。 FullEnrich 人员搜索使用 current_company_domains 和 current_position_seniority_level，而不是 company_domain、person_titles、titles 或 seniority。full_name、seniority 和 domain 等响应字段仅用于输出。

快速参考

任务	端点	价格	最适用于
搜索人员	https://stableenrich.dev/api/fullenrich/people-search	有结果时 $0.15	按域名／资历级别查找人员
搜索公司	https://stableenrich.dev/api/fullenrich/company-search	有结果时 $0.15	按条件查找公司
丰富人员信息	https://stableenrich.dev/api/pdl/people-enrich	匹配时 $0.28	LinkedIn URL／邮箱 -> 完整档案
丰富人员信息（替代方案）	https://stableenrich.dev/api/minerva/enrich	$0.05	人口统计信息、工作经历
丰富公司信息	https://stableenrich.dev/api/companyenrich/org-enrich	$0.06	域名 -> 公司数据
按名称／URL 查找公司	https://stableenrich.dev/api/companyenrich/properties-enrich	$0.06	未知域名时使用
联系方式补全	https://stableenrich.dev/api/clado/contacts-enrich	$0.20	查找缺失的邮箱／电话
验证邮箱	https://stableenrich.dev/api/hunter/email-verifier	$0.03	检查邮箱是否可送达
Minerva 解析	https://stableenrich.dev/api/minerva/resolve	$0.02	人员 -> Minerva PID + LinkedIn
Minerva 邮箱检查	https://stableenrich.dev/api/minerva/validate-emails	$0.01	检查 Minerva 数据库中的邮箱

对于社交媒体创作者，请使用 stablesocial.dev —— 网红相关端点不在 stableenrich.dev 上。

人员信息丰富（PDL）

优先使用 profile（LinkedIn URL）或 email：

npx agentcash@latest fetch https://stableenrich.dev/api/pdl/people-enrich -m POST -b '{"profile":"https://www.linkedin.com/in/johndoe"}'

npx agentcash@latest fetch https://stableenrich.dev/api/pdl/people-enrich -m POST -b '{"email":"[email protected]"}'

有效输入：email、profile，或 first_name + last_name +（company_name 或 company_domain）。未匹配时：HTTP 200，data: null —— 不收费。

公司信息丰富（CompanyEnrich）

npx agentcash@latest fetch https://stableenrich.dev/api/companyenrich/org-enrich -m POST -b '{"domain":"stripe.com"}'

人员搜索（FullEnrich）

从 域名 + 资历级别 开始；只有需要精确匹配职位名称时才添加 current_position_titles。

npx agentcash@latest fetch https://stableenrich.dev/api/fullenrich/people-search -m POST -b '{
  "current_company_domains": [{"value": "stripe.com"}],
  "current_position_seniority_level": [{"value": "VP"}]
}'

关键筛选条件：

• current_company_domains —— 公司域名
• current_position_seniority_level —— 枚举值：C-level、VP、Head、Director、Manager 等
• current_position_titles —— 精确匹配职位名称（返回结果会少得多）
• person_locations、person_professional_network_urls，以及其他 20 多个 FullEnrich 筛选条件

无效字段：单独使用 offset、company_domain、titles、seniority、limit、Apollo 的 person_titles／person_seniorities。

每次查询最多返回 10 人。people 为空 → 不收费。

公司搜索（FullEnrich）

npx agentcash@latest fetch https://stableenrich.dev/api/fullenrich/company-search -m POST -b '{
  "domains": [{"value": "anthropic.com", "exact_match": true}]
}'

至少需要一个搜索筛选条件。通过 metadata 中的 search_after 进行分页。

联系方式补全（Clado）

npx agentcash@latest fetch https://stableenrich.dev/api/clado/contacts-enrich -m POST -b '{
  "linkedin_url": "https://www.linkedin.com/in/johndoe",
  "email_enrichment": true,
  "phone_enrichment": true
}'

Minerva 身份解析

npx agentcash@latest fetch https://stableenrich.dev/api/minerva/resolve -m POST -b '{
  "records": [{"record_id": "user_001", "first_name": "John", "last_name": "Smith", "emails": ["[email protected]"]}]
}'

每条记录至少需要一个邮箱或电话号码；仅凭姓名无法匹配。

Minerva 信息丰富

npx agentcash@latest fetch https://stableenrich.dev/api/minerva/enrich -m POST -b '{
  "records": [{"record_id": "user_001", "linkedin_url": "https://www.linkedin.com/in/johndoe"}],
  "return_fields": ["full_name", "personal_emails", "phones", "work_experience"]
}'

查询方式：按 minerva_pid（最快）、每条记录中的 linkedin_url，或按姓名／邮箱／电话号码查询。

Minerva 邮箱验证

npx agentcash@latest fetch https://stableenrich.dev/api/minerva/validate-emails -m POST -b '{
  "records": ["[email protected]", "[email protected]"]
}'

成本优化

先搜索，再丰富信息：fullenrich/people-search（有结果时 $0.15）-> pdl/people-enrich（匹配时 $0.28）-> hunter/email-verifier（$0.03）。

处理多条记录时，使用并行的 fetch 调用 —— 没有批量信息丰富端点。

FullEnrich 人员搜索支持使用 excludeFields 精简响应大小（例如 ["educations", "skills", "languages"]）。

电子邮件验证（Hunter）

npx agentcash@latest fetch https://stableenrich.dev/api/hunter/email-verifier -m POST -b '{"email":"[email protected]"}'

状态枚举：valid、invalid、accept_all、webmail、disposable、unknown。快速/缓存检查会立即返回最终结果；如果 Hunter 仍在处理中，响应会包含一个 jobId — 使用 GET /api/hunter/email-verifier/jobs/{jobId} 轮询（免费，SIWX，使用支付时相同的钱包）。

处理缺失数据

1. 重新运行 discover，并尝试 PDL、Minerva 和 Clado 联系人
2. 在搜索人员之前，使用 companyenrich/org-enrich 验证公司域名
3. 在 stableenrich.dev 上使用 Exa 查找 LinkedIn URL，然后重试 enrich

对于社交媒体创作者，请使用 stablesocial.dev。