data-enrichment

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	条件に合う企業を検索
LinkedIn スクレイピング	https://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. 検出結果または上記のクイックリファレンス表に記載された正確な URL を使用して、x402.fetch でエンドポイントを呼び出します
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]"
  }
)

返される情報：信頼度スコア付きの確認済みメールアドレスと電話番号。

一括処理

1 回のリクエストで最大 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 - ソーシャルリンクが不要な場合

一括処理と個別処理

• 個別処理：1 件あたり $0.0495
• 一括処理（10 件）：合計 $0.495 = 1 件あたり $0.0495

一括処理は 1 件あたりの価格は同じですが、複数件をより速く処理できます。

エンリッチする前に検索

適切なレコードを見つけてからエンリッチするには、検索エンドポイント（$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 などの追加情報を探し、その情報を使ってさらに絞り込んだクエリを実行してください。