mcpField

sales-enrichso

github.com/sales-skillsマーケティング・グロース37 回インストール
リポジトリ

sales-enrichso について

B2BデータエンリッチメントAPIプラットフォーム、Enrich.soの利用を支援する営業向けスキルです。営業、RevOps、エンジニアリング、マーケティングチームに、検索、バッチ処理、API連携の手順を案内します。

主な機能

  1. 01人物・企業データの補完案内
  2. 02メール・電話番号の検索手順
  3. 03一括処理とWebhookの案内
  4. 04API連携の説明
  5. 05メール検証の案内

活用シーン

  1. 01メールアドレスからCRM連絡先を補完
  2. 02意思決定者のメール検索と検証
  3. 03訪問者のIPから企業を特定
  4. 04類似企業の見込み客リスト作成

インストール

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

$npx skills add https://github.com/sales-skills/sales --skill sales-enrichso

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
enrichso-api-reference.md
learnings.md
platform-guide.md

詳細

Enrich.so プラットフォームのヘルプ

Reverse Email Lookup や LinkedIn Profile Enrichment から、Email/Phone Finder、Company Data、Similar Company Search、Employee Search、IP to Company、Job Listings、Bulk Enrichment、Email Validation まで、Enrich.so プラットフォームに関する質問に対応します。Enrich.so は、検索 1 件につき 50 以上のデータポイントを提供するリアルタイム B2B データエンリッチメント API プラットフォームです。クレジットは成功ベースのモデルで、検証済みの結果に対してのみ料金が発生します。

Step 1 — コンテキストを確認する

references/learnings.md が存在する場合は、蓄積された知識を確認するため、まず読みます。

ユーザーに次の質問をします。

  1. Enrich.so のどの機能についてサポートが必要ですか?

    • A)Reverse Email Lookup — メールアドレスから LinkedIn プロフィール、職位、会社、50 以上のデータポイントを検索
    • B)LinkedIn Profile Enrichment — LinkedIn URL からプロフィールの全データを取得(学歴、職歴、スキル、連絡先情報、ネットワーク情報)
    • C)Email Finder — 氏名と会社名、または LinkedIn URL から、検証済みのビジネスメールアドレスを検索
    • D)Phone Number Finder — プロフィールから電話番号を検索、Email to Phone、Mobile Finder
    • E)Company Data Lookup — 会社名、ドメイン、LinkedIn URL から会社の詳細情報を検索(業種、規模、売上、テックスタック、ソーシャルプロフィール)
    • F)Company Funding & Traffic — 資金調達ラウンド、投資家、金額、ウェブトラフィックの推定値
    • G)Search Similar Companies — フィルター(所在地、従業員数)を指定して、LinkedIn URL から類似企業を検索
    • H)Search Company Employees — 会社名と職種から意思決定者を検索し、詳細なプロフィールを取得
    • I)IP to Company — IP アドレスから会社を特定(リモートワーカーを含む)
    • J)Job Listings — 会社の求人情報をリアルタイムで検索
    • K)Bulk Enrichment — CSV アップロード、JSON 配列、CSV URL と Webhook コールバックによる一括処理
    • L)Email Validation / Disposable Email Check / Reverse Email Append
    • M)Integrations / API — REST API、Zapier、n8n、Make、Webhook
    • N)Account / Billing — プラン、料金、クレジット
    • O)その他 — 内容を説明してください
  2. あなたの役割は何ですか?

    • A)営業/SDR/BDR
    • B)RevOps/営業オペレーション
    • C)開発者/エンジニア
    • D)グロース/マーケティング
    • E)採用担当者/人材獲得
    • F)その他
  3. 何を達成しようとしていますか?(具体的な目標や質問を説明してください)

ユーザーの依頼にすでにコンテキストの大部分が含まれている場合は、該当するステップに直接進みます。 妥当な前提を明示したうえで、可能な範囲で最善の回答をまず提示し、最後に最も重要な確認質問を 1~2 件だけ尋ねます。必要なコンテキストがすべて揃うまで回答を保留しないでください。

注:ユーザーに専門的なスキルが必要な場合は、そのスキルのほうが適している理由を簡潔に説明して案内します。

Step 2 — 適切なスキルに案内するか、直接回答する

依頼が専門スキルに該当する場合は、次のように案内します。

  • プラットフォーム横断のエンリッチメント戦略/複数ツールによるエンリッチメント → /sales-enrich
  • メール配信到達性/検証戦略(Enrich.so 固有ではないもの) → /sales-deliverability
  • 見込み客リストの作成戦略 → /sales-prospect-list
  • ミドルウェアを使った Enrich.so と他のツールの接続 → /sales-integration
  • Apollo.io 固有の質問 → /sales-apollo
  • ZoomInfo 固有の質問 → /sales-zoominfo
  • Clearbit 固有の質問 → /sales-clearbit

それ以外の場合は、以下のリファレンスに基づき、プラットフォームに関する知識から直接回答します。

Step 3 — Enrich.so プラットフォームのリファレンス

詳細なモジュールのドキュメント、料金、連携、データモデルについては、references/platform-guide.md を読みます。

プラットフォームガイドの詳細を確認する必要はもうありません。ユーザー固有の状況に注力してください。

ステップ 4 — 具体的なガイダンス

ユーザーの具体的な質問に基づいて、次のように対応します。

  1. メール連絡先リストを LinkedIn のデータで充実させる:

    1. email 列を含む CSV としてリストを準備します
    2. Bulk Enrichment エンドポイントを使用します:type person を指定して POST /v1/api/bulk-enrichment を呼び出し、CSV をアップロードします(または JSON 配列か CSV URL を渡します)
    3. 処理完了時にコールバックを受け取るには、リクエスト本文に webhookUrl を含めます。これにより、ポーリングを避けられます
    4. 送信時に返された uid を使用して、GET /v1/api/bulk-enrichment-results?uid=<uid> から結果を取得します
    5. 結果には、LinkedIn URL、役職、会社、所在地、および一致した各メールアドレスの 50 を超えるデータ項目が含まれます
    6. 充実させたデータを CRM にインポートし、フィールドを CRM の連絡先プロパティにマッピングします
    7. 正常にデータを充実できたレコードのみクレジットを消費します。一致しなかったメールアドレスには課金されません
  2. 対象アカウントの意思決定者のメールアドレスを見つける:

    1. 対象企業の LinkedIn URL またはドメインから始めます
    2. Search Company Employees を使用して、役職で人物を検索します。「VP Sales」「Head of Engineering」「CTO」などの役職で絞り込みます
    3. 一致した従業員ごとに、LinkedIn to Email を使用して勤務先のメールアドレスを取得します
    4. アプローチする前に、Email Validation エンドポイントで各メールアドレスを検証します。全件受信ドメインや無効なメールボックスがないか確認します
    5. 必要に応じて Phone Number Finder を使って電話での接点を追加し、マルチチャネルのシーケンスを組み立てます
    6. 大量のアカウントリストを処理する場合は、type find-email を指定した Bulk Enrichment を使用します
  3. IP to Company でウェブサイト訪問者の匿名性を解除する:

    1. ウェブサーバーのログまたは分析プラットフォームから訪問者の IP アドレスを取得します
    2. 各 IP アドレスを指定して GET /v1/api/ip-to-company を呼び出します
    3. Enrich.so は、関連する会社名、ドメイン、業種、規模、LinkedIn URL を返します。リモートワーカーにも対応します
    4. 返された企業を自社の ICP 基準(業種、規模、売上高)と照合し、フォローアップの優先順位を決めます
    5. 優先度の高い一致候補について、Company Data Lookup を使用して詳細な企業統計情報を取得します
    6. Search Company Employees を使用して、特定した各企業の適切な連絡先を見つけます
    7. Zapier(IP to Company トリガー)または任意の統合プラットフォームを使って、パイプラインを自動化します
  4. 類似企業リストを作成する:

    1. 最良の顧客の LinkedIn 企業 URL を特定します
    2. 各 URL を指定して POST /v1/api/similar-companies を呼び出します。必要に応じて、所在地と従業員数で絞り込み、自社の ICP に合わせます
    3. 結果には関連性スコアが含まれます。選択したしきい値を超えるスコアの企業を優先します
    4. 有望な一致候補に Company Data Lookup を使用して、詳細な企業統計情報(業種、売上高、技術スタック)を取得します
    5. Search Company Employees を使用して、新たな対象アカウントの意思決定者を見つけます
    6. Email Finder または LinkedIn to Email を使用して、アプローチ先の連絡先情報を取得します
  5. Enrich.so API 連携を設定する:

    1. enrich.so に登録し、ダッシュボードから API トークンを取得します
    2. すべてのリクエストに Authorization ヘッダーを設定します:Authorization: Bearer <your-token>
    3. 単一の検索を実行してテストします:GET https://api.enrich.so/v1/api/[email protected]
    4. レスポンスを処理します。HTTP ステータスコードを確認してください。成功は 200、一致なし(クレジットは消費されません)は 404、認証エラーは 401、レート制限は 429 です
    5. 一括処理では、個別の呼び出しを繰り返すのではなく、非同期の一括データ充実エンドポイントを使用します。より効率的で、レート制限を回避できます
    6. ポーリングを避けるため、一括リクエスト本文に webhookUrl を含めて、一括ジョブのウェブフックコールバックを設定します
    7. Enrich.so ダッシュボードでクレジット使用量を監視し、予期しない枯渇を防ぐアラートを設定します

注意点

調査に基づくベストエフォートの内容です。特に、プランによって利用が制限される機能や連携に関する注意点は古くなっている可能性があるため、確認してください。

  1. 成功した場合のみ課金されるため、検索に失敗しても料金はかかりませんが、クレジットの消費量はエンドポイントによって異なります。予算を立てる前に、料金ページでエンドポイントごとのクレジット消費量を確認してください。 個人情報のエンリッチメント検索では、企業検索や電話番号検索とは異なるクレジット数が消費される場合があります。検索件数の合計だけでなく、使用するエンドポイントの内訳に基づいてクレジットの配分を計画してください。
  2. 一括エンリッチメントは非同期で実行されるため、結果をポーリングするか、ウェブフックを使用する必要があります。 一括ジョブを送信すると、すぐに uid が返されますが、応答には結果が含まれません。ジョブが完了するまで GET /v1/api/bulk-enrichment-results?uid=<uid> をポーリングするか、リクエストに webhookUrl を含めて通知を受け取る必要があります。大規模なデータセットのジョブは、サイズによって数分から数時間かかることがあります。
  3. LinkedIn プロフィールのエンリッチメントは LinkedIn URL の形式に依存するため、正規のプロフィール URL を使用してください。 https://www.linkedin.com/in/username 形式の完全な URL を渡してください。短縮 URL、Sales Navigator の URL、クエリパラメーター付きの URL は正しく解決されない場合があります。API を呼び出す前に、トラッキングパラメーターを削除してください。
  4. IP アドレスから企業を特定する精度はさまざまです。共有 IP、VPN、クラウドプロバイダーを使用している場合、特定の企業を特定できません。 このエンドポイントは、リモートワーカーについては企業の IP 範囲と ISP から企業へのマッピングで最も効果を発揮しますが、VPN、共有オフィススペース、クラウドベースのブラウジングを使用する訪問者の場合、誤った結果や結果なしとなることがあります。一致率は 100% を下回ることを想定し、優先度の高い一致結果は検証してください。
  5. Zapier 連携で利用できるのは、特定のトリガー/アクション(逆引きメール検索、IP アドレスから企業の特定)に限られます。それ以外のエンドポイントには、REST API を直接使用するか、カスタム Zapier ウェブフックのステップを使用してください。 Enrich.so のすべてのエンドポイントで、Zapier のネイティブなトリガー/アクションを利用できるわけではありません。類似企業、従業員検索、一括エンリッチメントなどのエンドポイントには、Zapier のウェブフックアクションを使用するか、HTTP リクエストノードで n8n/Make と連携する必要があります。
  • 継続的な改善:ここに記載されていない情報を見つけた場合は、今日の日付を付けて references/learnings.md に追記してください。

ステップ 5 — 関連スキル

  • /sales-enrich — クロスプラットフォームのデータエンリッチメント戦略(複数ツールを使ったエンリッチメントワークフロー、ウォーターフォール型エンリッチメント)
  • /sales-deliverability — メールの到達率と検証戦略(SPF/DKIM/DMARC、ウォームアップ、受信トレイへの到達)
  • /sales-prospect-list — 見込み客リストの作成戦略とベストプラクティス
  • /sales-integration — Enrich.so を CRM、自動化ツール、その他のプラットフォームに接続
  • /sales-do — どのスキルを使うべきかわからない場合:ルーターが営業に関するあらゆる目的に適したスキルを照合します。インストール:npx skills add sales-skills/sales --skill sales-do

例

例 1:LinkedIn と企業データを使った CRM 連絡先のエンリッチメント

ユーザーの発言:「CRM にメールアドレスしか登録されていない連絡先が 500 件あります。それぞれに LinkedIn プロフィール、役職、企業情報を追加したいです。」 スキルの動作:

  1. email 列を含む CSV として連絡先をエクスポートすることを推奨します
  2. タイプに person を指定して一括エンリッチメント(POST /v1/api/bulk-enrichment)を使用し、CSV をアップロードします。非同期ワークフローとウェブフックコールバックの選択肢について説明します
  3. ジョブの完了後、GET /v1/api/bulk-enrichment-results?uid=<uid> で結果を取得します
  4. 返されたフィールド(linkedin_url、job_title、company_name、company_domain、location)を、ユーザーの CRM 連絡先プロパティに割り当てます
  5. 一致した連絡先のみクレジットを消費し、一致しなかったメールには料金がかからないことを説明します
  6. 結果に含まれる一意の企業ドメインに対して企業データ検索を実行し、アカウントレベルで企業属性データ(業種、規模、売上高)を追加することを推奨します 結果:ユーザーは、LinkedIn プロフィール、役職、企業情報でエンリッチメントされた 500 件の連絡先を取得でき、セグメント化とパーソナライズされたアプローチに活用できます
例 2:ターゲットアカウントの意思決定者のメールアドレスを検索して検証する

ユーザーの発言:「アウトバウンドキャンペーン用に、ターゲット企業20社のエンジニアリング担当VPのメールアドレスを調べる必要があります。」 スキルの動作:

  1. ユーザーから20社のLinkedIn URLまたはドメインを収集します
  2. 各企業についてSearch Company Employeesを使用し、役職に「VP」を含み、部門が「Engineering」である従業員に絞り込みます
  3. 条件に一致した従業員ごとにLinkedIn to Emailを使用して、勤務先のメールアドレスを検索します
  4. Email Validationエンドポイントで各メールアドレスを検証し、キャッチオールドメイン、無効なメールボックス、役割ベースのアドレスにフラグを付けます
  5. 必要に応じてPhone Number Finderを使用し、マルチチャネルでのアプローチ用に直通電話番号を追加します
  6. メールアドレス、電話番号、LinkedIn URL、役職を含む、検証済みの意思決定者20名の整理されたリストを提供します 結果:ユーザーは、パーソナライズされたアウトバウンドシーケンスにすぐ活用できる、検証・エンリッチメント済みのエンジニアリング担当VPの連絡先リストを入手できます
例 3:購買意欲の高いウェブサイト訪問者を特定し、営業チームにつなぐ

ユーザーの発言:「月間10K人がウェブサイトを訪問していますが、誰なのかはわかりません。Enrich.soを使えば、サイトを訪問している企業を特定できますか?」 スキルの動作:

  1. IP to Companyエンドポイントについて説明します。ウェブサーバーのログや分析ツールから訪問者のIPアドレスを取得し、APIを呼び出して各IPアドレスに対応する企業を特定します
  2. 自動化されたパイプラインを設定します:訪問者のIPアドレス -> IP to Company API -> ICPの条件(業界、従業員数、売上高)で絞り込み -> 営業チームに通知
  3. コード不要で設定するにはZapierのIP to Company連携を、リアルタイム処理にはカスタムWebhookを推奨します
  4. 企業が特定できたら、Company Data Lookupを連携して企業の詳細な属性情報を取得し、Search Company Employeesで適切な購入者ペルソナを見つけます
  5. VPNユーザー、共有IPアドレス、クラウドプロバイダーのIPアドレスは特定できないため、トラフィックの構成によって企業の一致率は20~40%になると説明します
  6. 優先順位を付けてアプローチするために、求人情報のシグナル(自社製品が対応する職種を募集している企業)と組み合わせることを提案します 結果:ユーザーは、サイトを訪問する購買意欲の高い企業を特定し、エンリッチメント済みのリードを営業チームにつなぐ自動化された訪問者特定パイプラインを構築できます

トラブルシューティング

一括エンリッチメントジョブが停止している、または結果が不完全

症状:POST /v1/api/bulk-enrichmentで送信した一括エンリッチメントジョブがuidを返しますが、GET /v1/api/bulk-enrichment-resultsをポーリングしても長時間処理中のままになっているか、結果の一部の行が欠けています。 原因:大規模な一括ジョブの処理には時間がかかります。非同期処理のため、結果はすぐには返されません。入力ファイルの形式に問題(不正なCSV、必須列の不足、エンコーディングの問題)がある場合や、処理できない無効なデータを含む行がある場合、結果が不完全になることがあります。 解決策:まず入力ファイルが有効であることを確認してください。CSVはUTF-8でエンコードし、エンリッチメントの種類に応じた正しい列ヘッダー(人物のエンリッチメントではemail、LinkedInのエンリッチメントではlinkedin_urlなど)を指定する必要があります。ジョブがまだ処理中の場合は、ポーリングを続けるか、Webhookコールバックを待ってください。大規模なジョブ(10K行以上)は、完了までに30分から数時間かかることがあります。行が欠けている場合は、ジョブのステータスでエラー数を確認してください。個別に失敗した行がある可能性があります。失敗した行は別のバッチで再送信してください。ジョブが恒久的に停止しているように見える場合は、ジョブuidを添えてEnrich.soのサポートにお問い合わせください。

有効なメールアドレスで逆引きメール検索を行っても結果が返されない

症状:既知の有効なビジネスメールアドレスで逆引きメール検索エンドポイントを呼び出しても、その人物にLinkedInプロフィールがあるにもかかわらず、一致する結果が返されません(HTTP 404または空の結果)。 原因:Enrich.soの逆引きメール検索では、メールアドレスがLinkedInプロフィールまたはその他のインデックス済みデータソースに関連付けられている必要があります。その人物がLinkedInで別のメールアドレスを使用している場合、プロフィールが非公開の場合、またはメールアドレスとプロフィールの対応関係がインデックスに登録されていない場合は、一致する結果が返されません。無料メールプロバイダー(Gmail、Yahoo)は、ビジネスドメインより一致率が低くなります。 解決策:メールアドレスのスペルが正しく、その人物のメインのビジネスメールアドレスであることを確認してください。無料プロバイダーのメールアドレスを使用している場合は、代わりにその人物の仕事用メールアドレスを試してください。ビジネスドメインのほうが一致率が大幅に高くなります。別の方法として、その人物の名前と会社がわかっている場合は、メール検索エンドポイントでビジネスメールアドレスを見つけてから、そのアドレスで逆引き検索を試してください。LinkedIn URLがわかっている場合は、逆引き検索ではなく、LinkedInプロフィールエンリッチメントを直接使用してください。

有効なトークンにもかかわらず、APIが401 Unauthorizedを返す

症状:ダッシュボードでAPIトークンが正しいように見えるにもかかわらず、APIリクエストがHTTP 401を返します。 原因:よくある原因として、コピーしたトークンの前後に空白がある、Authorizationヘッダーの形式が正しくない(Basicやトークンだけではなく、Bearer <token>である必要があります)、トークンが再生成されて古いものを使用している、または請求関連の問題でアカウントが停止されていることが挙げられます。 解決策:Enrich.soのダッシュボードからトークンを新たにコピーしてください。末尾の空白や改行文字がないか確認してください。ヘッダーの形式がAuthorization: Bearer <token>と完全に一致し、「Bearer」の後にスペースが1つだけあることを確認してください。現在有効なトークンを使用していることを確認してください(トークンを再生成すると、以前のトークンは無効になります)。アカウントが正常な状態であることを確認してください。ダッシュボードで請求に関するアラートや停止通知を確認してください。簡単なcURLコマンドでテストし、問題がコードにあるのかトークン自体にあるのかを切り分けてください:curl -H "Authorization: Bearer <token>" "https://api.enrich.so/v1/api/[email protected]"。

コメント