mcpField
C
contact-enrichment

contact-enrichment

github.com/cold-iqマーケティング・グロース349 回インストール2 週間前に更新
リポジトリ

contact-enrichment について

マーケティング業務向けの連絡先エンリッチメントスキルです。ColdIQのエンドポイントで企業のLinkedInページ、メールアドレス、電話番号を調べ、低コスト順にメールを検索して、送信前に検証します。

主な機能

  1. 01企業のLinkedIn URLを解決
  2. 02勤務先・個人メールを検索
  3. 03低コスト順のメール検索フロー
  4. 04送信前にメールを検証
  5. 05電話番号を検索
  6. 06処理済み連絡先をスキップ

活用シーン

  1. 01アウトリーチ前の連絡先リストの補完
  2. 02メールキャンペーン前のアドレス検証
  3. 03対象連絡先の電話番号検索

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cold-iq/coldiq-marketplace-skills --skill contact-enrichment

インストール後、Claude Code で/contact-enrichmentを入力して読み込まれたか確認します。

同梱ファイルresources/async-job-pattern.mdresources/credit-optimization.md

詳細

連絡先情報の補完

連絡先リストを対象に、LinkedIn の URL、仕事用／個人用メールアドレス、電話番号を検索します。ColdIQ のエンドポイントを低コストのものから順に使い、すでに情報を補完済みの連絡先はスキップします。従来の複数プロバイダーを使ったメール検索のウォーターフォール（Prospeo → Findymail → FullEnrich、その後に検証）は、ColdIQ のマーケットプレイスエンドポイントだけで完結するため、プロバイダーごとのアカウントを管理せず、1つのキーと統合クレジットを利用できます。

ColdIQ マーケットプレイスエンドポイント

タスクメソッドパスクレジットエンドポイント ID備考
ドメインから会社の LinkedIn URL を検索POST/v1/limadata/find/company-linkedin1limadata.find.company_linkedinLinkup /enrich/linkedin の代替
仕事用メールアドレス（氏名＋ドメイン）POST/v1/limadata/find/work-email1limadata.find.work_email見つからない場合は無料
仕事用メールアドレス（LinkedIn URL）POST/v1/limadata/find/work-email-linkedin3limadata.find.work_email_linkedinフォールバック
個人用メールアドレスPOST/v1/limadata/find/personal-email5limadata.find.personal_email最後の手段
電話番号POST/v1/limadata/find/phone10limadata.find.phone見つからない場合は無料
メールアドレスの検証（バウンスチェック）POST/v1/findymail/verify1findymail.verifyDebounce の代替
Prospeo によるメール検索（ウォーターフォールのステップ）POST/v1/prospeo/enrich-person不明prospeo.enrich_personウォーターフォールの最初
Findymail によるメール検索（LinkedIn）POST/v1/findymail/search/business-profile1findymail.search.business_profileウォーターフォールのステップ
FullEnrich によるメール検索（一括）POST/v1/fullenrich/contact/enrich/bulk結果ごとfullenrich.contact.enrich_bulk最終手段、非同期
人物情報の補完（プロフィール）POST/v1/limadata/enrich/person1～5limadata.enrich.person詳細プロフィール

レイヤー 1 — 会社の LinkedIn URL

会社のドメインをもとに、まず LinkedIn の会社ページを特定します（後続のステップで必要です）。 → POST /v1/limadata/find/company-linkedin · 1 クレジット · limadata.find.company_linkedin

レイヤー 2 — メール検索のウォーターフォール（低コストのものから順に試し、見つかった時点で終了）

  1. 氏名＋会社のドメインを試します。 → POST /v1/limadata/find/work-email · 1 クレジット · limadata.find.work_email
  2. 見つからない場合、またはドメインがない場合は、LinkedIn URL を使います。 → POST /v1/limadata/find/work-email-linkedin · 3 クレジット · limadata.find.work_email_linkedin
  3. 同じ LinkedIn URL を使って、別のプロバイダーで検索します。 → POST /v1/findymail/search/business-profile · 1 クレジット · findymail.search.business_profile
  4. フォールバックとして、プロバイダーのエンリッチメントを使います。 → POST /v1/prospeo/enrich-person · ? クレジット · prospeo.enrich_person（未検証）
  5. それでも見つからない情報を補完するための最終手段です（一括、非同期。詳しくは resources/async-job-pattern.md を参照）。 → POST /v1/fullenrich/contact/enrich/bulk · 結果ごと · fullenrich.contact.enrich_bulk
  6. 仕事用メールアドレスがどうしても見つからない場合に限り、個人用メールアドレスを検索します。 → POST /v1/limadata/find/personal-email · 5 クレジット · limadata.find.personal_email

通常の累積ヒット率は、連絡先の質に応じて 85～95% です。

レイヤー 3 — 送信前に検証

未検証のメールアドレスは送信者の評判を損ないます。見つかったメールアドレスはすべて検証してください。 → POST /v1/findymail/verify · 1 クレジット · findymail.verify

ステータス対応
Valid / Deliverable安全に送信できます
Risky / Accept-all注意して送信してください（キャッチオールドメイン）
Invalid / Undeliverable送信しないでください
Unknown別のプロバイダーで再試行してください

電話番号

→ POST /v1/limadata/find/phone · 10 クレジット · limadata.find.phone（見つからない場合は無料。LinkedIn URL または氏名＋会社を使用）

コストの最適化

resources/credit-optimization.md を参照してください。主なルールは次のとおりです。 最初に重複を除去し（list-dedup）、低コストの入力から試し、最初に見つかった時点で終了します。 全リストを処理する前に 50～100 件でテストし、有効またはリスクありのメールアドレスだけをキャンペーンにエクスポートします。

チェックリスト

  • エンリッチメントを行う前に連絡先の重複を削除する
  • 企業の LinkedIn URL を解決する（レイヤー 1）
  • メールアドレスのウォーターフォールを最も安価な方法から実行し、見つかった時点で停止する（レイヤー 2）
  • 見つかったメールアドレスをすべて検証する（レイヤー 3）
  • まず 50～100 行でテストし、ヒット率が 50% 未満の場合はデータ品質を確認する
  • 検証済みまたはリスクありのメールアドレスのみをキャンペーンにエクスポートする（無効なメールアドレスは絶対に含めない）

コメント

Markdown 対応