Apollo

@pipeworx/apollo

Apollo.io の企業・人物データ：組織の検索とエンリッチメント、人物の検索とエンリッチメント、企業の現在の求人情報を利用できます。ご自身の Apollo API キーをご用意ください。すべての呼び出しは、ご自身の Apollo アカウントとそのクレジット残高を使って実行されます。

Pipeworx の一部です。AI エージェントを 1872 以上の稼働中のデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとの提携、同社による推奨、または同社による公開を受けていません。

ツール

• apollo_search_organizations(...) — 業界、従業員数、本社所在地、利用中のテクノロジー、資金調達の履歴・規模で企業を検索します。
• apollo_enrich_organization(...) — ドメイン、ウェブサイト、または LinkedIn URL から企業 1 社の情報を補完します。業界、従業員数、売上高、資金調達ラウンド、テクノロジーを取得できます。
• apollo_search_people(...) —役職、職位レベル、勤務先のドメインまたは組織 ID で人物を検索します。姓は一部が伏せられた状態で返され、メールアドレスや電話番号は返されません。実際の連絡先情報を確認するには、apollo_enrich_person と組み合わせてください。
• apollo_enrich_person(...) — メールアドレス、LinkedIn URL、または氏名とドメイン・組織の組み合わせから、特定の人物 1 名の情報を補完します。役職、職位レベル、部署、勤務先に加え、アカウントで利用可能な場合は勤務先メールアドレスを取得できます。
• apollo_org_job_postings(...) — Apollo の organization_id を指定して、企業の現在の求人情報（役職、勤務地、掲載日・最終確認日）を取得します。

認証

ご自身の API キーのみを使用します。すべてのツールで、Apollo アプリの Settings → Integrations → API から取得したご自身の Apollo API キーを _apiKey に指定する必要があります（https://docs.apollo.io/docs/create-api-key を参照）。Pipeworx が Apollo キーを保持したり、代わりのキーを使用したりすることはありません。_apiKey を指定しない場合、すべてのツールはネットワーク呼び出しを行う前に処理を拒否し、必要な引数とキーの取得先ページを示します。

スコープ付きキーでは、対象のエンドポイントを有効にする必要があります（Apollo ではキーごとにエンドポイントのスコープを設定できます）。マスターキーは 5 つすべてのエンドポイントで使用できます。Apollo が定める制限は、エンドポイントごとに 1 時間あたり 600 回です。

クレジット費用（Apollo が課金する費用）

• apollo_search_organizations — 1 ページあたり 1 クレジット（1 ページあたり最大 100 件）。
• apollo_enrich_organization — 情報を補完する組織 1 件あたり 1 クレジット。
• apollo_search_people — 0 クレジット（このエンドポイントはメールアドレスや電話番号を返しません）。
• apollo_enrich_person — メールアドレスまたは属性データが見つかった場合は 1 クレジット、携帯電話番号を取得する場合のみさらに 8 クレジット（このパックではリクエストされません）、一致する情報がない場合は 0 クレジット。
• apollo_org_job_postings — 1 ページあたり 1 クレジット（求人情報は合計最大 10,000 件）。

Pipeworx がこれらの費用に上乗せしたり、再販売したりすることはありません。Apollo の利用分として、Apollo からお客様のアカウントに請求されます。Pipeworx 独自の呼び出しごとの料金は別途発生し、Apollo のクレジット費用とは関係ありません。

データソース

• Apollo.io — お客様自身の Apollo アカウントですでにアクセスできる企業・連絡先データベース（組織、人物、求人情報）。

既知の制約と注意点

• apollo_search_people はメールアドレスも電話番号も返しません。 Apollo はこのエンドポイントをクレジット不要にするため、意図的にこれらの情報を含めていません。取得できるのは、名、伏せ字の姓、has_email などの真偽値です。結果に対して apollo_enrich_person を呼び出すと、実際の連絡先情報を解決できる場合があります。
• 一致したもののロックされているメールアドレスは、Apollo から文字列 email_not_unlocked@<domain> として返されます。 HTTP 200 で返され、null でもエラーでもありません。このパックではこのプレースホルダーを未取得として扱います。apollo_enrich_person はプレースホルダーの文字列自体を返さず、email: null, email_locked: true に変換します。ロック解除にはご自身の Apollo クレジットまたはプランが必要です。このパックでは変更できません。
• 電話番号の開示には対応していません。 Apollo の reveal_phone_number は非同期で、応答ではなく webhook_url に後から番号を送信するため、状態を持たない単一のツール呼び出しに適切に対応付けることができません。このパックでは実装していません。電話番号の取得には Apollo のダッシュボードまたは API を直接ご利用ください。
• シーケンス、連絡先やリストの作成、メールの送信には対応していません。 Apollo の API はこれらすべてをサポートしていますが、このパックでは意図的にどれも実装していません（docs/gtm-wave-2026-10-08.md の D3）。
• プラットフォームキーは一切使用しません。 このパックは意図的に BYOK のみとしています（D4）。Apollo は個人データのベンダーであり、D4 では新たなプラットフォームキー方式のベンダーを追加することが禁止されています。このパックのゲートウェイマニフェスト項目に platformKeyEnv を追加しないでください。
• 列挙済みの値は含まれていません。 Apollo の業種タグ ID と 1,500 件以上のテクノロジー UID は、どちらも Apollo が管理する拡張可能なリストであり、ここでは列挙されていません。これらのフィールドは通常の string／string[] です。正確な値は Apollo UI のフィルターで確認してください。
• 他のメール検索ベンダーと並んで、enrich_find_email（@pipeworx/enrich-waterfall）でベンダーの一つ（_apolloKey）としても利用できます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "apollo": {
      "url": "https://gateway.pipeworx.io/apollo/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/apollo/mcp の tools/list は、上記の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール一式）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとともに共有ツールがおよそ 30 件表示されます。接続の initialize 応答には正確な範囲が記載されており、その日の時点での確定情報です。

これは意図的な設計であり、偶然に多重化しているわけではありません。メタツールを使えば、ask_pipeworx を介してカタログ全体にわたりルーティングできるため、このパックの対象外の質問にも、2 つ目の MCP サーバーを追加せずに回答できます。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと 1872 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらから接続しても、ask_pipeworx ですべてのツールを利用できます。

MCP クライアントがない場合：HTTP で呼び出す

このパックではご自身の API キー（_apiKey）を使用します。こちらでは API キーを代行しないため、キーなしで実行できる curl の例はありません。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/apollo_search_organizations を使用してください。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用してください。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行でき、Pipeworx アカウントやゲートウェイとの往復通信は不要です。

{
  "mcpServers": {
    "apollo": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-apollo"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-apollo

標準入力／標準出力を介して MCP で通信し、initialize／tools/list／tools/call に対して、このパックのツールのみを使って応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックのエンドポイントでも、完全なゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Apollo data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT