mcp-career-change-signal-engine

Career Change Signal Engine MCP サーバー

Apify上のMamba Labs Career Change Signal Engineアクター用MCPサーバーです。Career Change Signal Engineはウォッチリスト内の人物を調査し、前回の確認以降に変化した情報だけを返します。誰が退職したか、次にどこへ移ったか、誰が後任になったか、役職の募集終了後に誰が就任したかを確認できます。各行には、人物の照合方法、情報を取得したソース、そのソースの情報の古さが示されます。

内容

• できること
• クイックスタート
• 前提条件
• プロンプトの例
• ツール
• 入力
• 料金
• ご自身のキー
• アクターの全ドキュメント
• ライセンス

できること

連絡先のウォッチリストを読み込み、前回の実行以降に変化した情報だけを返します。誰が退職したか、次にどこへ移ったか、誰が後任になったか、役職の募集終了後に誰が就任したかを確認できます。各行には、根拠、ソースの日付、セグメント、最初のメッセージ案に加えて、Slack、HubSpot、HeyReach、Instantly向けのペイロードが含まれます。people（必須）に加え、必要に応じてreplies、bounces、posting changes、suppression、自前のプロバイダーキーをproviderKeysに渡せます。LinkedInを取得することはなく、独自のキーも保持しません。状態はwatch_list_idごとに保持されます。実行に失敗した場合は、実行IDとともにエラーとして返されます。APIFY_TOKENが必要で、呼び出しごとにApifyクレジットを消費します。

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

クイックスタート

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

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

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

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

前提条件

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

プロンプトの例

• 「過去のチャンピオン50人を確認して、誰が退職し、どこへ移ったか教えてください。」
• 「ウォッチリストを実行し、転職した各人物に最初に送るメッセージ案を作成してください。」

ツール

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

{
  "people": [
    {
      "person_name": "Jane Doe",
      "company_domain": "example.com",
      "company_name": "Example Inc",
      "title": "Head of Content",
      "external_id": "example-1"
    }
  ],
  "watch_list_id": "default"
}

入力

ライブアクターに渡すすべての購入者向け入力をそのまま使用します。省略した入力には、アクター独自のデフォルト値が適用されます。

入力	型	必須	説明
people	array	はい	ウォッチリストです。1 人につき 1 つのオブジェクトを指定します。内容：person_name、profile_url（任意）、company_domain、company_name、title、work_email、relationship（prospect、mgl、deal_contact、customer_champion）、external_id、crm_id、deal_id、known_history（HeyReach のコピー、Proofed LinkedIn reader の行、または一般的な役割）、last_reading（state_source が caller の場合）。エンジンが読み取るのは、ここに指定した人物だけです。1 回の実行につき max_people_per_run 以下にしてください。
watch_list_id	string	いいえ	リストの名前です。state_source が actor の場合、ウォッチリスト ID ごとに状態が保存されます。
state_source	string	いいえ	actor：エンジンが名前付きストアに実行間の状態を保持します。caller：人物ごとに last_reading を渡し、状態を自分で管理します。
read_mode	string	いいえ	stored_first：まず known_history を使用し、次にキーを使用します。live_only：known_history を無視します。stored_only：known_history のみを使用し、キー呼び出しは行いません。
first_run_mode	string	いいえ	report：初回実行で検出したすべての変更を返します。baseline：初回実行では状態を保存して何も返さず、contact_checked のみ課金します。
max_people_per_run	integer	いいえ	リストがこの上限を超えると、読み取りや課金を行う前に実行が失敗します。デフォルトは 150、上限は 1,000 です。
providerKeys	object	いいえ	独自のキーです：serper または serpapi（ウェブ検索）、prospeo、bounceban（検証）、findymail、exa。状態、出力、ログ、Webhook には書き込まれません。実行入力として送信する独自のキーであり、アクターには保存されません。
linkedin_reader_dataset_id	string	いいえ	任意。同じ Apify アカウントで実行した Proofed LinkedIn reader のデータセット ID です。行は profile URL を使って人物と結合されます。
replies	array	いいえ	任意の返信テキストです：external_id または work_email または profile_url、text、received_at、channel、is_auto_reply。テキストは分類後に破棄され、sha1 のみが保持されます。
bounces	array	いいえ	任意のバウンス情報です：work_email、bounce_type、smtp_code、smtp_text、bounced_at。
posting_changes	array	いいえ	任意の Account Hiring Watch の行です。掲載が終了すると、その企業で新たな採用検索が開始されます。
suppression	object	いいえ	emails、profile_urls、opted_out_emails、opted_out_profile_urls、company_domains、company_names。抑制対象の人物は読み取り前に除外され、費用はかかりません。
icp_tiers	object	いいえ	任意の企業ドメインからティアへのマップです。ランディングした行に表示されます。行が除外されることはありません。
features	object	いいえ	切り替え項目：replacement、closed_posting、contact_data、first_line、icp、include_promotions。include_promotions を除き、デフォルトでは有効です。
sender_context	string	いいえ	任意。ファーストラインの下書きに使うトピックのフレーズです。例：content production at scale。
max_replacement_candidates	integer	いいえ	離職者 1 人につき提案する候補者数です。各候補者は本人が確認します。
max_spend_usd	integer	いいえ	この金額を超える課金が発生する前に実行を停止します。
sweep_interval_days	integer	いいえ	state_source が actor の場合、この日数以内に読み取った人物はスキップされます。
concurrency	integer	いいえ	同時に読み取る人物数です。
webhook_url	string	いいえ	任意。1 リクエストにつき最大 100 件のシグナル行を送信する、署名付き Standard Webhooks POST です。
webhook_secret	string	いいえ	署名シークレットです。whsec_ 値は Base64 でデコードされます。実行入力として送信する独自のキーであり、アクターには保存されません。

料金

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

イベント	無料プラン	Bronze	Silver	Gold
contact_checked、確認した連絡先 1 件あたり	$0.02	$0.019	$0.018	$0.017
signal_delivered、配信した変更行 1 件あたり	$0.068	$0.0646	$0.0612	$0.0578
apify-actor-start、実行開始 1 回あたり	$0.001	$0.001	$0.001	$0.001

キーについて

このアクターは、プロバイダーのキーを独自には保持しません。有料プロバイダーのキーはすべてお客様のもので、入力として渡され、Apify によってシークレット入力として保存されます。キーがない場合、アクターはそのステップをスキップし、実行時にその旨を通知します。

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

apify.com/mambalabs/career-change-signal-engine

ライセンス

MIT。LICENSEをご覧ください。