mcp-new-hire-finder

New Hire Finder MCP サーバー

Apify上のMamba Labs New Hire Finderアクター向けMCPサーバーです。ここ数カ月以内に企業で役職に就いた人を見つけます。企業ドメイン、営業対象の役職、遡る期間を指定すると、人物ごとに1行のデータが返されます。氏名、プロフィールURL、役職、入社月、前職、異動種別（新規採用または社内昇進）、およびその人物を見つけた情報源が含まれます。

内容

• 機能
• クイックスタート
• 前提条件
• プロンプトの例
• ツール
• 入力
• 料金
• APIキーについて
• アクターのドキュメント全文
• ライセンス

機能

指定した期間内に、指定した役職に就いた人を企業から探します。company_domain（または company_domains）、target_titles、lookback_monthsを指定してください。人物ごとに、氏名、プロフィールURL、役職、入社月、前職、異動種別（新規採用、社内昇進、または発表のみ）、情報源を含む、Clayですぐに使えるフラットなJSON行が返されます。また、企業ごとに、該当者が見つかったか、または調査できなかった理由を示すサマリー行が1行返されます。入力として渡されたお客様自身のProspeo、Serper、SerpApi、またはExaのキーと、送信された人物リストを使用して実行されます。LinkedInから情報を取得することはなく、独自のキーも保持しません。実行が成功しなかった場合は、実行IDとともにエラーが返されます。読み取り専用です。APIFY_TOKENが必要で、呼び出しごとにApifyクレジットを消費します。

すべての処理はApify上で実行されます。このパッケージは、アクターの実行を開始して完了を待ち、データセットの行を返すシンプルなクライアントです。

クイックスタート

Node.js 18以降と、APIトークンを持つApifyアカウントが必要です。

これをClaude Desktopの設定ファイル（claude_desktop_config.json）、Cursor、または任意のMCPクライアントに追加してください。

{
  "mcpServers": {
    "mamba-new-hire-finder": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-new-hire-finder"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

クライアントを再起動すると、find_new_hiresツールが表示されます。

前提条件

• Node.js 18以降。
• console.apify.com/account/integrationsから取得したApify APIトークンをAPIFY_TOKENとして設定します。サーバーはトークンなしでもツールを一覧表示しますが、呼び出しにはトークンが必要です。

プロンプトの例

• 「過去6か月以内にexample.comでマーケティング職に就いたのは誰ですか？」
• 「6月以降に、これら10社で新たに就任したコンテンツ責任者を見つけてください。」

ツール

find_new_hires。ツールは1つです。引数の例：

{
  "company_domain": "example.com",
  "target_titles": [
    "marketing"
  ],
  "lookback_months": "6"
}

入力

稼働中のアクターが購入者向けに公開している入力項目を、そのまま使用します。省略された入力には、アクター独自のデフォルト値が適用されます。

入力	型	必須	説明
company_domain	string	いいえ	会社のドメインを1つ指定します（例：zapier.com）。これを使うか、Company domains（一括）を使います。両方の結果は統合されます。
company_domains	array	いいえ	会社のドメインのリストです。各社について個別の要約行が作成されます。
company_name	string	いいえ	任意です。単一企業の実行でのみ使用します。空欄の場合、ホームページから社名を読み取ります。
target_titles	array	いいえ	マッチ対象の役職名のフレーズです（例：marketing、head of content、editor）。フレーズのすべての単語が完全一致する場合、その役職名がマッチします。Prospeo とウェブ検索にも役職フィルターとして送信されます。
seniority	array	いいえ	任意です。指定した職位レベルのみを対象にします。
departments	array	いいえ	任意です。指定した部門のみを対象にします。
exclude_titles	array	いいえ	任意です。たとえば intern など、指定したフレーズを含む役職名を除外します。
expand_title_synonyms	boolean	いいえ	短い同義語リストもマッチ対象にします（marketing は growth、brand、demand generation にもマッチします）。行ごとに課金されるため、デフォルトではオフです。
lookback_months	string	いいえ	今月を含め、何暦月前までさかのぼるかを指定します。1～24、デフォルトは6です。10月の場合、6は5月から10月までを意味します。Clay から送信できるよう、テキストとして指定します。
move_types	array	いいえ	返却対象と課金対象にする異動の種類です。new_hire は別の雇用主から移ってきた人、promotion は同じ雇用主での新しい役職、unknown は職歴情報のない入社発表を表します。デフォルトでは new_hire のみです。
include_year_only	boolean	いいえ	開始時期が年単位でしか分からず、期間内に該当する可能性がある人も返します。通常の行と同様に課金されます。デフォルトではオフです。
people	array	いいえ	役職履歴を含む、すでに保有している人物データです。各項目には person_name、company_domain、profile_url（任意）、および {title, company_name, start (YYYY-MM), end (YYYY-MM or null)} のリストである roles を指定します。同じ期間、役職、異動のルールが適用されますが、プロバイダーへの問い合わせは行われません。
sources	array	いいえ	実行する取得元です。デフォルトはすべてです。buyer_data は保有する人物リストです。prospeo と web_search はお客様のキーがある場合のみ実行され、news、newsroom、team_pages は無料です。
prospeo_api_key	string	いいえ	お客様自身の Prospeo キーです。開始月と異動の種類の根拠となる職歴を取得します。Prospeo の検索結果1ページ（25人）ごとに1クレジット、人物情報の補完1人ごとに1クレジットがかかり、Prospeo からお客様に請求されます。保存されることはありません。実行時の入力としてお客様自身のキーを送信します。アクターに保存されることはありません。
web_search_provider	string	いいえ	使用する検索キーを指定します。auto は利用可能な最初のキーを選びます。順序は Serper、SerpApi、Exa です。
serper_api_key	string	いいえ	ウェブ検索用のお客様自身の Serper.dev キーです。デフォルトでは会社ごとに1回検索します。検索結果に開始日は含まれないため、Prospeo キーで日付を補完するか、日付不明として扱います。実行時の入力としてお客様自身のキーを送信します。アクターに保存されることはありません。
serpapi_api_key	string	いいえ	ウェブ検索用のお客様自身の SerpApi キーです。Serper とは異なるベンダーです。実行時の入力としてお客様自身のキーを送信します。アクターに保存されることはありません。
exa_api_key	string	いいえ	お客様自身の Exa キーです。Exa の人物検索では開始月を含む職歴が返されるため、結果の補完は不要です。実行時の入力としてお客様自身のキーを送信します。アクターに保存されることはありません。
max_people_per_company	string	いいえ	会社ごとに返す人物行の最大数です。開始日が新しい順に並びます。1～100、デフォルトは25です。
max_search_queries_per_company	string	いいえ	お客様のキーを使って会社ごとに実行するウェブ検索クエリ数です。1～4、デフォルトは1です。
max_enrich_per_company	string	いいえ	ウェブ検索、見出し、チームページで見つかった人物の日付を補完するため、会社ごとに実行する Prospeo の補完呼び出し数です。0～25、デフォルトは5です。
max_prospeo_pages_per_company	string	いいえ	会社ごとの Prospeo 検索ページ数です。1ページあたり25人です。1～4、デフォルトは1です。
max_charge_usd	number	いいえ	任意です。この実行の費用が指定額を超える課金が発生する前に実行を停止し、すでに課金済みの行はすべて保持します。空欄の場合は、Apify で設定した実行あたりの最大費用のみが適用されます。実行ではこの上限も遵守されます。
skip_cache	boolean	いいえ	同じ会社とフィルターで過去7日以内に実行されていても、再検索します。キャッシュされた結果は無料で返されます。

料金

Apifyではイベントごとに課金され、料金はApifyアカウントに請求されます。価格は米ドルです。

イベント	無料プラン	Bronze	Silver	Gold
new_hire_found、取得した人物1人あたり	$0.085	$0.08075	$0.0765	$0.07225
apify-actor-start、実行開始1回あたり	$0.001	$0.001	$0.001	$0.001

ご自身のキー

アクターはプロバイダーキーを保持していません。有料プロバイダーキーはすべてご自身のもので、入力として渡され、Apifyによってシークレット入力として保存されます。キーがない場合、アクターはそのステップをスキップし、実行結果にその旨を表示します。

アクターの完全なドキュメント

apify.com/mambalabs/new-hire-finder

ライセンス

MIT。LICENSEを参照してください。