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 を実行します

stableenrich.dev のエンドポイントには、必ず npx agentcash@latest fetch を使用してください。curl や WebFetch は使用しないでください。

フィールド名を推測しないでください。 FullEnrich の人物検索では、company_domain、person_titles、titles、seniority ではなく、current_company_domains と current_position_seniority_level を使用します。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 DB 内のメールアドレスを確認

ソーシャルメディアのクリエイターについては、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 OR 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}]
}'

少なくとも 1 つの検索フィルターが必要です。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 による ID 解決

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]"]}]
}'

各レコードには少なくとも 1 つのメールアドレスまたは電話番号が必要です。名前だけでは一致を判定できません。

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 を使用してください。