mcp-b2b-prospect-engine

Prospect Engine MCP サーバー

Apify上のMamba Labs Prospect Engine アクター用のMCPサーバーです。

1つのアクターで4つのモードを利用できます。すでに保有している企業情報の拡充、指定したキーワードで採用中の企業の発見、企業内の担当者の検索、または途中にICPゲートを設けた一連の処理の実行です。

インストール

npx -y @mambalabsdev/mcp-b2b-prospect-engine

Claude Desktop

{
  "mcpServers": {
    "mamba-b2b-prospect-engine": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-b2b-prospect-engine"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

Apifyトークンはconsole.apify.com/account/integrationsで取得できます。

ツール

run_prospect_engine

1つのアクターで4つのモードを利用できます。すでに保有している企業情報の拡充、指定したキーワードで採用中の企業の発見、企業内の担当者の検索、または途中にICPゲートを設けた一連の処理の実行です。

入力	型	必須	備考
mode	enum	いいえ	実行する処理です。enrich_companies は各企業の識別、企業情報、LinkedIn、ソーシャル情報を解決します。discover_jobs は指定したキーワードで採用中の企業を見つけ、求人情報から実際の雇用主を特定します。find_contacts は各企業の担当者を見つけます。full は3つすべてを連続して実行します。デフォルト："enrich_companies"。次のいずれかです：enrich_companies、discover_jobs、find_contacts、full。
domains	array	いいえ	1行につき1つのドメインを指定します。enrich_companies と find_contacts で使用します。
company_names	array	いいえ	1行につき1つの名前を指定します。ドメインは不明で、名前はわかっている場合に使用します。
keywords	array	いいえ	検索する職種です。discover_jobs と full で使用します。例：コピーエディター、校正者、コンテンツエディター。デフォルト：["copy editor", "proofreader", "content editor"]。
country	string	いいえ	求人検索に使う2文字の国コードです。例：us または gb。デフォルト："us"。
location	string	いいえ	求人検索に使う任意の勤務地フィルターです。例：New York。
lookback_days	string	いいえ	指定した日数より古い求人を除外します。Clay はすべてのフィールドを文字列として送信するため、文字列として送信されます。デフォルト："30"。
max_results	string	いいえ	1回の実行で返す求人の上限です。幅広いキーワードを指定しても件数が増えすぎないようにします。デフォルト："25"。
max_pages	string	いいえ	1～5。各ページで SerpAPI を1回呼び出すため、求人検索のコストを主に左右する設定です。デフォルト："1"。
new_postings_only	string	いいえ	true にすると、前回の実行で確認されていない求人だけを返します。デフォルト："false"。
previous_run_date	string	いいえ	実行間キャッシュが利用できない場合に差分を検出するための YYYY-MM-DD 形式の基準日です。
remote_only	string	いいえ	true にすると、求人サイトでリモートと表示されている求人だけを残します。デフォルト："false"。
company_size_min	string	いいえ	従業員数がこの値を下回る企業を除外します。従業員数が判明している場合にのみ有効なため、full モードと、従業員数が含まれている求人検索結果に適用されます。求人検索だけでは企業情報を補完しません。
company_size_max	string	いいえ	従業員数がこの値を上回る企業を除外します。最小値と同じ条件で適用されます。
exclude_staffing	string	いいえ	true にすると、人材派遣会社や採用会社の求人を除外します。デフォルト："true"。
exclude_marketplaces	string	いいえ	true にすると、Upwork、Fiverr、Freelancer などのギグ案件を除外します。デフォルト："true"。
extra_marketplaces	array	いいえ	除外するマーケットプレイス名を追加します。
fetch_posting_page	string	いいえ	求人情報だけでは雇用主を特定できない場合、求人ページを開きます。処理は遅くなりますが、雇用主に代わって求人サイトが掲載した求人も検出できます。デフォルト："true"。
target_contacts	string	いいえ	1～25。デフォルト："3"。
target_roles	array	いいえ	指定した職種のいずれかにタイトルが該当しそうな担当者だけを補完します。有料のメール検索を行う前に絞り込むため、条件に一致しない担当者には費用がかかりません。空のままにすると、職位と部門のフィルターで許可された担当者をすべて残します。
deny_tokens	array	いいえ	タイトルが対象職種に一致していても担当者を除外する単語です。例：product を指定すると Product Owner を除外し、Production Editor は残します。対象職種が指定されていない場合も適用されます。
company_concurrency	string	いいえ	同時に処理する企業数です。同時実行されるプロバイダー呼び出し数は、この値と contact_concurrency の積になります。6 x 3 = 18 は、文書化されているプロバイダーの最も厳しい上限を下回ります。デフォルト："6"。
contact_concurrency	string	いいえ	1社内で同時に補完する担当者数です。メールのウォーターフォール処理は常に順番に実行されます。デフォルト："3"。
max_spend_usd	string	いいえ	自分が負担するベンダー利用料（Findymail、Icypeas、Prospeo、BounceBan）がこの金額に達したら、有料ベンダーへの呼び出しを停止し、それまでに完了した結果を返します。これはベンダーへの請求額の上限であり、このアクターに対する Apify の料金には適用されません。上限なしの場合は空欄にします。
max_charge_usd	number	いいえ	実行時にこのアクターに対して発生する Apify 料金（USD）の上限です。この上限を超える料金は発生させず、実行を停止し、その旨を示す通知行を1つ返します。自分が負担するベンダー利用料に上限を設定する max_spend_usd とは別です。
job_titles	array	いいえ	担当者を検索する際に使用する職位です。
seniority	array	いいえ	c_level、vp、director、manager、senior。
departments	array	いいえ	marketing、sales、engineering、product、finance、hr、operations、legal。
include_email	string	いいえ	true にすると、メールのウォーターフォール処理を実行します。Icypeas または Prospeo のキーが必要です。キーは利用者が指定し、料金も利用者に直接請求されます。デフォルト："false"。
verify_email	string	いいえ	true にすると、各メールアドレスを検証します。BounceBan のキーが必要です。デフォルト："true"。
verify_position	string	いいえ	true にすると、提供された証拠だけを基に、記録されている各担当者の職位が妥当で、現在も有効だと考えられるかをモデルに確認します。claude_api_key が必要です。キーがない場合はスキップされます。企業の公式ウェブサイトで見つかった担当者はスキップされます。デフォルト："true"。
personalize	string	いいえ	true にすると、メールアドレスがある各担当者について、企業に関する具体的な内容に触れた1～2文の書き出しを作成します。claude_api_key が必要です。キーがない場合はスキップされます。デフォルト："true"。
brand_voice	string	いいえ	書き出しの文体です。空欄にすると、簡潔で率直な文体で作成されます。
score_icp	string	いいえ	true にすると、ICP のルールに照らして各行をスコアリングし、A～D に分類します。デフォルト："true"。
icp_preset	enum	いいえ	適用するスコアリングモデルです。"editorial_services" は、コピー編集と校正のマネージドサービスを販売する企業向けにスコアリングします。"generic_b2b" は、サービス固有の語彙を使わず、採用意欲、雇用主の特定可能性、従業員数に基づいてスコアリングします。デフォルト："editorial_services"。次のいずれかです：editorial_services、generic_b2b。
min_icp_score	string	いいえ	full モードでは、この値以上のスコアを獲得した企業のみ、担当者の検索に進みます。デフォルトは45です。25の場合、キーワード検索で見つかった編集関連の求人はすべてフィルターを通過しました。これは、そのような求人が取り得る最低スコアが25だからです。デフォルト："45"。
extra_exclude_names	array	いいえ	名前に指定した文字列のいずれかが含まれる企業を除外します。
signal_taxonomy	array	いいえ	デフォルトのシグナル種別を上書きします。各項目は type、strength、title_keywords、および任意の also_keywords と description_keywords を含むオブジェクトです。
include_social	string	いいえ	true にすると、LinkedIn と併せて Facebook、Instagram、X、YouTube も特定します。デフォルト："true"。
source_timeout_secs	string	いいえ	5～120。指定時間を超えたソースは利用低下としてマークされ、実行は続行されます。デフォルト："30"。
skip_cache	string	いいえ	true にすると、実行間で共有される7日間のキャッシュを無視し、すべてを再計算します。デフォルト："false"。
serper_api_key	string	いいえ	Serper.dev のキーです。find_contacts で人物検索を行うために使用します。カバレッジが最も高い検索レイヤーです。このキーがない場合、無料の代替手段の精度は明らかに低くなります。
findymail_api_key	string	いいえ	Findymail のキーです。メールのウォーターフォール処理で最初に使用するプロバイダーです。
icypeas_api_key	string	いいえ	Icypeas のキーです。Findymail で見つからなかった場合に使用します。
prospeo_api_key	string	いいえ	Prospeo のキーです。Findymail と Icypeas で見つからなかった分に使用します。
bounceban_api_key	string	いいえ	BounceBan のキーです。2番目の検証サービスで、キャッチオールの場合に使用します。
serpapi_key	string	いいえ	SerpApi のキーです。discover_jobs と full で必要です。Serper のキーとは別のもので、異なるベンダーのキーです。
claude_api_key	string	いいえ	利用者自身の Anthropic キーです。職位の検証とパーソナライズされた書き出しに使用します。キーがない場合は、どちらの処理もスキップされます。保存されません。

課金

基本エンリッチメントとフルエンリッチメントでは料金が異なり、エンリッチメントした企業ごと、検証した連絡先ごと、発見した求人情報ごとに課金されます。ベンダー API 呼び出しの料金は、各ベンダーから直接請求されます。max_spend_usd を設定すると、実行ごとのベンダーへの支出に上限を設定できます。また、target_roles を設定すると、対象とする職種以外の連絡先に対する有料検索をスキップできます。verify_position と personalize は、独自の Anthropic キー（claude_api_key）を使用して実行され、キーがない場合はスキップされます。

Apify の無料プランにおけるイベントごとの料金です（ライブ料金レコードに基づく）。有料の Apify プランでは、イベントごとの料金がさらに安くなります。

イベント	料金（USD）
企業のエンリッチメント、基本（company-enriched-basic）	0.02
企業のエンリッチメント、フル（company-enriched-full）	0.08
連絡先の検証（contact-verified）	0.015
求人情報の発見（job-posting-discovered）	0.01
企業のエンリッチメント、基本、連鎖実行（company-enriched-basic-composed）	0.015
企業のエンリッチメント、フル、連鎖実行（company-enriched-full-composed）	0.06
連絡先の検証、連鎖実行（contact-verified-composed）	0.01125
求人情報の発見、連鎖実行（job-posting-discovered-composed）	0.0075
企業のエンリッチメント、フル、予約料金（company-enriched-full-founding）	0.05
連絡先の検証、予約料金（contact-verified-founding）	0.009
求人情報の発見、予約料金（job-posting-discovered-founding）	0.005

料金はApify のアクターページに記載されています。このサーバーを実行すると、Apify クレジットが消費されます。

このサーバーが行うこと、行わないこと

このサーバーは Apify アクター用の薄いクライアントです。入力をそのまま渡し、アクターの出力を変更せずに返します。上記の動作はすべてこのサーバーではなく、アクター側で行われます。

エラーは握りつぶされず、そのまま通知されます。無効な入力、無効なトークン、残高不足、タイムアウト、またはデータセット以外を返す実行は、空の結果ではなく、明示的なツールエラーとして返されます。

このツールはアクターの実行を開始し、完了ステータスになるまでポーリングするため、実行時間の長い処理が 300 秒で打ち切られることはありません。実行には最大 1,800 秒が許可されます。それを過ぎてもさらに 2 分間処理が続いている場合、呼び出しは待機を停止し、Apify Console で実行結果を確認できるリンクとともに実行 ID を返します。結果は処理が完了するとそこに表示されます。実行が成功しなかった場合は、実行 ID とステータスを含むエラーが返されます。多数の企業を対象にした full または find_contacts の実行には数分かかることがあるため、この動作が重要になります。

ソース

アクターは Apify Store にあります。このラッパーは MIT ライセンスで提供されています。

マムバラボによって開発されました。