mcpField
A
apollo-search

apollo-search

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

apollo-search について

Apollo Searchは、ColdIQが再販するApolloエンドポイントで人物や組織を検索し、選んだレコードを補完するスキルです。Apollo形式のフィルターと、検索結果のIDを集めて一括補完する手順を扱います。

主な機能

  1. 01役職や企業条件で人物を検索
  2. 02企業属性で組織を検索
  3. 03人物と組織のレコードを補完
  4. 041回の呼び出しで最大10人を一括照合
  5. 05所在地、規模、資金調達、シグナルで絞り込み

活用シーン

  1. 01アウトバウンド営業向けの見込み客リスト作成
  2. 02業界、規模、所在地による企業検索
  3. 03候補者のプロフィール情報の補完

インストール

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

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

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

詳細

Apollo Search

Apollo の 2億1,000万件以上の連絡先と3,500万社以上の企業を検索してターゲットリストを作成し、さらに情報を補完します — ColdIQ が再販する Apollo エンドポイント /v1/apollo/* を通じて利用できます（Apollo と同じフィルターの仕様で、ColdIQ のキーは1つです）。リストの作成には Apollo を使い（検索＋フィルター）、メールアドレスの情報補完には coldiq-search-enrich を使います。

ColdIQ Marketplace エンドポイント

タスクメソッドパスクレジットエンドポイント ID備考
人物を検索POST/v1/apollo/people/search1apollo.people.search役職、役職レベル、所在地、会社
組織を検索POST/v1/apollo/organizations/search1apollo.organizations.search業界、規模、所在地
1人の情報を補完POST/v1/apollo/people/match1apollo.people.match名前／メール／LinkedIn → 完全なプロフィール
人物の一括情報補完（≤10人）POST/v1/apollo/people/bulk-match1/人apollo.people.bulk_match1回につき10人
1組織の情報を補完POST/v1/apollo/organizations/enrich1apollo.organizations.enrichドメインから企業属性全体を取得
組織の一括情報補完（≤10社）POST/v1/apollo/organizations/bulk-enrich1/社apollo.organizations.bulk_enrich一部データのみ — 注意点を参照
Apollo ID で組織情報を取得POST/v1/apollo/organizations/info1apollo.organizations.info

標準的なワークフロー：検索してから情報を補完

  1. フィルターを指定して人物を検索します（ID と基本情報が返され、メールアドレスは含まれません）。 → POST /v1/apollo/people/search · 1 cr · apollo.people.search 
    { "person_titles": ["VP Sales", "Head of Growth"], "person_seniorities": ["vp", "director"],
  "organization_num_employees_ranges": ["51,200"], "per_page": 100, "page": 1 }
  2. 結果から ID を収集します。
  3. 10人ずつまとめて情報を補完します（一人ずつ処理しないでください）。 → POST /v1/apollo/people/bulk-match · 1/人 · apollo.people.bulk_match
  4. これでメールアドレス、電話番号、LinkedIn の URL、職歴を取得できます。

会社の企業属性全体を取得するには、一括ではなく単一組織の情報補完を使います： → POST /v1/apollo/organizations/enrich · 1 cr · apollo.organizations.enrich

主なフィルター

会社： organization_num_employees_ranges、売上高の範囲、q_organization_keyword_tags （業界／キーワード）、organization_locations、資金調達ステージ、使用テクノロジー、求人情報、設立年、部門ごとの従業員数、購買インテント（Organization プランのみ）。

人物： person_titles、person_seniorities（c-suite、vp、director）、部門、 person_locations、include_similar_titles、最近の転職、現職の在職期間、メール／電話番号の有無、 contact_email_status

従業員数の範囲（API の値）
"1,10"  "11,50"  "51,200"  "201,500"  "501,1000"  "1001,5000"  "5001,10000"  "10001,50000"

実証済みの検索設定（例）

  • 紹介経由の上限に達した創業者： 従業員10～200人、売上高100万～1,000万ドル、ソフトウェア／インターネット、Seed／Series A、 米国／英国／西ヨーロッパ、営業部門0～2人 → 役職：Founder／CEO／Owner。
  • DIY のアウトバウンド営業がうまくいかなかった企業： 従業員10～100人、Apollo／Lemlist／Instantly／Outreach／SalesLoft を使用、営業 部門1～5人 → VP Sales／Head of Growth／Founder。
  • エンタープライズ向け B2C： 従業員501人以上、売上高1億ドル以上、金融／自動車／小売／保険／製薬、米国 → CMO／VP Growth／Head of Brand／Head of SEO。

フィルターの設定

広い条件（業界＋規模＋所在地）から始めて → 件数を確認し（目標：500～5,000件）→ キーワードを追加 → シグナル（テクノロジー／インテント／求人情報）を追加 → 最後に人物フィルターを追加します。少なすぎる場合（500件未満）は規模の条件を緩めます。 多すぎる場合（10,000件超）は資金調達ステージまたは部門ごとの従業員数を追加します。

注意点

  1. 業界は自己申告です — 「Information Technology & Services」は広範な分類です。
  2. 売上高は推定値です — 売上高が1,000万ドル未満の非公開企業では信頼性が低くなります。
  3. テクノロジー情報はウェブサイトのトラッキングのみです — Slack や Notion などの社内ツールは表示されません。
  4. 従業員数は急成長中のスタートアップでは3～6か月遅れることがあります。
  5. 組織の一括情報補完では一部データのみが返されます — latest_funding_stage、total_funding、 annual_revenue、technology_names[] は取得できません。企業属性全体を取得するには、単一組織の情報補完を使います。
  6. 検索ではメールアドレスは返されません — 検索後に情報を補完してください。
  7. 購買インテントには Organization プランが必要です。

Apollo と ai-ark と Exa

必要なこと最適なツール
65 以上のフィルターを使った大規模な企業検索Apollo (apollo.organizations.search)
非常に大規模な人物リストを結果ごとの料金で検索ai-ark (ai_ark.people.search、coldiq-search-enrich を参照)
データベースにないニッチな企業や新しい企業の検索Exa (exa.search)
既知の連絡先をエンリッチしてメールアドレスを取得coldiq-search-enrich のウォーターフォール

コメント

Markdown 対応