JobScout MCP

JobScout MCP

プライバシーを最優先にした、接続先を自分で用意するマルチソース求人検索用の MCP サーバーです。JobScout は、出典情報、決定的な重複排除、AI／Web3 に特化したシグナルを備えた、正規化済みの求人プールを AI エージェントに提供します。

JobScout は信頼できる求人検索のみに範囲を限定しています。履歴書の保存、候補者の評価、雇用主への連絡、求人への応募は行いません。

JobScout を選ぶ理由

• 検索対象のプロバイダーを有効にし、単一のソースだけで市場全体を網羅しないようにします。
• 求人の出典情報と、雇用主の正規応募ページへのリンクを分けて管理します。
• 個々のプロバイダーで障害が起きても、部分的な結果を返します。
• プロバイダーからの取得後に、リモート勤務と鮮度のフィルターを適用します。
• プロバイダーが適用できなかった条件を明示し、条件が適用されていない結果を、質問に回答したかのように返すことを防ぎます。
• AI、エージェント型、Web3 のシグナルを、ローカルで決定的に分類します。
• 候補者の本人情報とキャリア方針は、Career OS などのプライベートなクライアントで管理します。

MCP ツール

ツール	用途	ネットワーク
jobscout_list_sources	設定済みプロバイダー、トランスポート、対象範囲を表示します	なし
jobscout_search_jobs	有効な求人掲示板と求人アグリゲーターを検索し、正規化、フィルタリング、重複排除を行います	プロバイダーによります
jobscout_search_employers	設定した公式雇用主 ATS 掲示板（Greenhouse、Ashby、Lever）のみを、同じフィルターと開示項目に加え、宣言された出力スキーマを使って検索します	掲載された掲示板のみ
jobscout_classify_jobs	指定された求人から AI、エージェント型、Web3 のシグナルを検出します	なし
jobscout_deduplicate	指定された JobScout レコードを正規化して統合します	なし
jobscout_briefing	レコードを、簡潔な one_line と最適なリンクを含むブリーフィング用エントリーに変換します	なし
jobscout_source_yield	各ソースの提供内容（ユニークな求人、重複、雇用主ルートのカバー状況、日付のないレコード、競合）を報告します	なし

雇用主 ATS ソースには専用のツールがあるため、ツール名で許可または拒否を設定するデプロイでは、無料検索に手を加えずに、これらを別途提供できます（たとえば Pro 専用ツールとして）。無料検索では ATS ソースの結果は返されません。jobscout_list_sources は各ソースの search_tool を報告し、雇用主ソースを指定した無料検索では、検索せずに sources_elsewhere にそのソースを列挙します。両方の求人プールを統合するには、それらを jobscout_deduplicate に渡してください。

サーバーに情報を保存することなく、初回利用を案内する MCP プロンプトが 2 つあります。jobscout_setup はプロバイダーの有効化手順と、各プロバイダーが接続する先を案内します。jobscout_find_jobs は検索ごとに職種、勤務地、リモート勤務の希望を確認します。有効なプロバイダーが 0 件の状態で検索すると、誤解を招く空の結果ではなく、案内とともに setup_required: true が返されます。また、結果には providers_disabled、records_rejected（records_rejected_by_provider の内訳を含む）、undated_records、location_unfiltered、warnings が報告されるため、結果が少ない場合もその理由を常に確認できます。require_dated と include_descriptions を使えば、再現率より確実性を優先したり、不要な信頼できない説明文を除外したりできます。

クイックスタート

Node.js 22.13 以降が必要です。

npm exec --yes --package=@sarutobi-sasuke/jobscout-mcp -- jobscout-mcp

公開 Himalayas アダプターを有効にした Codex の例：

codex mcp add jobscout --env JOBSCOUT_ENABLE_HIMALAYAS=true -- npm exec --yes --package=@sarutobi-sasuke/jobscout-mcp -- jobscout-mcp

MCP ホストでは、GitHub からパッケージを直接実行することもできます。コミットを固定したり、未リリースのブランチをテストしたりする場合に便利です。

npm exec --yes --package=github:SarutobiSasuke8/jobscout-mcp -- jobscout-mcp

Claude Desktop、Cursor、ローカル開発、JobSpy、トラブルシューティングについては、インストール手順をご覧ください。

ChatGPT、Codex、Claude へのインストール

JobScout は、stdio 経由でローカル実行する方法（現在利用可能）と、ホスト型の Streamable HTTP サーバーとして実行する方法の 2 通りで動作します。ホスト型サービスは https://jobscout.mcprack.dev での提供を予定しており、deploy/ にすぐに使えるデプロイ手順がありますが、まだデプロイされていません。

ローカルでの実行（現在利用可能）

• Codex： codex mcp add jobscout --env JOBSCOUT_ENABLE_HIMALAYAS=true -- npm exec --yes --package=@sarutobi-sasuke/jobscout-mcp -- jobscout-mcp
• Claude Code： claude mcp add jobscout --env JOBSCOUT_ENABLE_HIMALAYAS=true -- npm exec --yes --package=@sarutobi-sasuke/jobscout-mcp -- jobscout-mcp
• Claude Desktop、Cursor、その他の JSON ホスト： インストール手順を参照してください。

ChatGPT および Codex プラグイン（JobScout Discover）

ディレクトリパッケージは plugins/jobscout-discover にあり、OpenAI のプラグイン形式に準拠しています。マニフェストと mcp.json は https://jobscout.mcprack.dev を参照しています。まだ掲載されていません。利用を開始するには、デプロイの公開、既存アカウントでのサインイン用 OAuth、デモアカウント、ポータルへの申請が必要です。審査資料と不足項目の全一覧はJobScout Discoverを、ホスティング手順と運用者向けランブックはデプロイを参照してください。

デプロイの公開後は、ChatGPT の開発者モードコネクタまたは Claude のカスタムコネクタから https://jobscout.mcprack.dev/mcp を指定できます。また、Claude Code では claude mcp add --transport http jobscout https://jobscout.mcprack.dev/mcp を使用できます。それまでは、上記のローカルインストールを使用してください。

プランは運用者自身のサイトでのみ販売されます。チャット内での購入手続きはありません。収益化を参照してください。

プロバイダー

プロバイダーはデフォルトで無効になっており、障害は個別に処理されます。

プロバイダー	トランスポート	認証	備考
Himalayas	リモート MCP	任意	公開求人検索です。雇用主のページは引き続き確認する必要があります
We Work Remotely	公開 RSS フィード	なし	キーワード検索エンドポイントはありません。結果はクライアント側で絞り込まれます
RemoteOK	公開 JSON エンドポイント	なし	最新求人フィードをクライアント側で絞り込みます。API の利用規約ではクレジット表記が求められています
Lenny's Job Board	HTTP 検索 API	なし	TrueUp の非公開エンドポイントを通じて、プロダクト、グロース、デザイン、エンジニアリング職を提供します。ボードへのリンクは求人発見用の URL です
JobSpy	ローカル Python サブプロセス	なし	python-jobspy は任意です。利用可能性とサイトの規約はそれぞれ異なります
Greenhouse、Ashby、Lever	公式の公開求人ボード API	なし	掲載されている会社の求人ボードごとに有効化します。雇用主の ATS 求人 URL が正式な URL です。検索に使用されるのは jobscout_search_employers のみで、jobscout_search_jobs では検索されません

プロバイダーの契約により、コアを特定のベンダーに依存させることなく、将来的に公式 ATS や専門求人ボードのアダプターを追加できます。プロバイダーのドキュメントを参照してください。

AI と Web3 のインテリジェンス

正規化された各求人には、AI エージェント、推論、評価、安全性、Web3 プロトコル、DeFi、DePIN、ウォレット、取引所、開発者向けインフラ、ゲーム、エージェント型コマースを網羅する決定論的な signals を含めることができます。現在、テクノロジーの検出対象には MCP、A2A、x402、LLM、RAG、Ethereum、Base、Solana が含まれています。

これらは検査可能な求人発見シグナルであり、内容が不透明な候補者スコアではありません。求人インテリジェンスを参照してください。

任意のエージェント運用ガイド

agents/jobscout-operator.md では、MCP 対応エージェント向けに、安全で再利用可能な求人発見ワークフローと出力仕様を定めています。架空のチームをまとめたものではなく、単一の機能を担う運用者として意図的に設計されており、非公開の候補者プロフィールや Career OS のポリシーは含まれていません。

信頼性と安全性

• プロバイダーからの応答は信頼できないものとして扱われ、スキーマに照らして検証されます。
• HTTP(S) のジョブ URL のみを受け付けます。
• リモート出力とサブプロセス出力には、明示的なサイズ制限と時間制限が設けられています。
• JobSpy はシェルを介さずに起動され、型付き JSON を標準入力経由で受け取ります。
• 自動応募、ログインの自動化、CAPTCHA の回避、認証情報の取得、プロキシの回避は行いません。
• プロバイダーの利用規約、求人情報の鮮度、勤務地の応募資格、雇用主の経路の確認については、引き続きユーザーが責任を負います。

サードパーティのプロバイダーを有効にする前に、SECURITY.md をお読みください。

開発

npm install
cp .env.example .env
npm run check
npm run smoke:mcp
npm run check:plugin

プロトコルのスモークテストには、公式の MCP Inspector を使用します。プロバイダーの追加には、フィクスチャ、エラー時の動作、出所情報の処理、テストが必要です。CONTRIBUTING.md をご覧ください。

検証

npm ci
npm test          # build, then every test under test/, offline
npm run check     # the full gate CI runs: lockfile, typecheck, lint, boundary, plugin, tests

テストでネットワークにアクセスすることはありません。各ソースアダプター（Greenhouse、Ashby、Lever、RemoteOK、We Work Remotely、Lenny's Job Board、Himalayas、および JobSpy ブリッジの出力）は、架空の企業と求人で構成された、記録された形式のフィクスチャを使って test/fixtures/sources/ で検証されます。出所情報（source、discovery URL、source job id、captured_at）を含む、正規化されたすべてのフィールドがチェックされます。test/dedupe-edge-cases.test.ts では、同じ求人が複数のソースから届くケース、表記や URL の違い、再掲載、および出所情報の統合方法を検証します。npm test は test/network-guard.ts を事前に読み込み、実際のネットワーク呼び出しを試みたテストを失敗させます。許可されるのはループバックのみです。CI では、すべてのプルリクエストに対して Ubuntu と Windows で npm run check を実行します。

リリース状況

次回のリリースには、より保守的な重複処理と、ストリーミングフィードのサイズ制限が含まれます。信頼性の根拠と残るリリース条件をご覧ください。新しいバージョンにタグを付けて公開するまでは、これらの変更は未リリースです。

npm の @sarutobi-sasuke/jobscout-mcp と、公式 MCP Registry の io.github.SarutobiSasuke8/jobscout-mcp で公開されています。リリースには GitHub で vX.Y.Z のタグが付けられ、CI が出所情報とともに npm に公開します。リリース手順とロールバックの順序については、RELEASING.md をご覧ください。

先行事例とライセンス

JobSpy は、コピーせずに MIT ライセンスのオプション依存関係として使用しています。borgius/jobspy-mcp-server は JobSpy の MCP ラッパーに対する需要を示しましたが、そのソースはここでは一切コピーしていません。

JobScout MCP は Apache-2.0 ライセンスです。サードパーティの依存関係には、それぞれのライセンスが適用されます。