jobfeed

jobfeed

jobfeed は、公式の公開ソースから稼働中の求人ボードを読み取る、ホスト型の Fairquery jobs MCP サーバーへの小規模なローカルブリッジです。1 社の求人ボードを取得したり、 企業が利用しているボードを特定したり、1 件の求人がまだ募集中か再確認したり、 求人情報を全件取得したり、検証済みのスターターボード一覧を表示したり、 勤務地と職種でそのスターターリストを検索したりできます。また、有料の企業検索では、 多数の企業の求人を履歴付きで監視できます。

このブリッジは求人データを独自に保持しません。ライブエンドポイントから取得した 上流サーバーのツール一覧をそのままローカルで提供し、各ツール呼び出しを上流へ転送して、 結果を変更せずに返します。取得対象は読み取り専用の公開求人ボードデータです。 応募、メッセージ送信、候補者データは含まれません。

ツール

• jobs_get_board — 1 つのボードに現在掲載されているすべての求人です。必須項目： ats と slug。任意のフィルターには、タイトルの包含／除外、勤務地、国、 リモート、掲載からの日数、説明の取得、ページングがあります。
• jobs_find_board — 企業名、ドメイン、採用ページ／ボードの URL から公開ボードを特定します。 必須項目：company。
• jobs_check_open — 1 件の求人がまだ掲載されているか再確認します。jobKey、 または ats + slug + jobId を指定し、任意で includeDescription を指定します。
• jobs_get_job — jobKey、または ats + slug + jobId から、 掲載中の 1 件の求人の詳細情報をすべて取得します。
• jobs_list_seed_boards — バンドルされている検証済みボードのスターターリストです。 任意で ats による絞り込みとページングができます。
• jobs_search_by_location — 企業名を指定せずに、勤務地と職種でスターターリストを検索します。 勤務地を示す情報が必要です：locations、countries、または remote "only"。
• jobs_search_companies — 有料の複数企業検索・監視ツールです。多数の企業またはボードを対象に、 履歴、新規／終了、再掲載のシグナルを取得します。

ボードは Greenhouse、Lever、Ashby のほか、名前付きの Personio、Pinpoint、Gem フィードに対応しています。

設定

• FAIRQUERY_JOBS_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://mcp.getfairquery.com/jobs/mcp です。（この上書き用フックは、この再構築で独自に 追加した旨を明記した再現要素です。）
• FAIRQUERY_JOBS_API_KEY（任意）— 設定すると、すべての上流リクエストに Authorization: Bearer <key> ヘッダーが付与されます。設定されていない場合、 キーのヘッダーは送信されません。上流の記録には認証ヘッダーが含まれていないため、 この転送も独自に追加した旨を明記した再現要素です。元のインターフェースは キーなしで取得されました。

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開きます。JSON-RPC の initialize リクエスト （protocolVersion 2025-03-26、clientInfo name jobfeed）、続いて notifications/initialized 通知、さらに呼び出し元の引数を変更せずに渡す tools/call リクエストを送信します。 上流が initialize に Mcp-Session-Id ヘッダーを付けて応答した場合、 その値はセッション内の後続リクエストすべてに付与され、プロセスの存続中は セッションが再利用されます。応答はプレーンな JSON またはサーバー送信イベントで 届く場合があり、どちらも読み取ります。

上流からの成功結果は、上流が設定した isError フラグも含め、そのまま返されます。 失敗 — JSON-RPC エラー、2xx 以外のステータス、読み取り不能な応答、 または完了できないリクエスト — は、テキストが jobfeed error: で始まる isError 結果として返されます（この形式は、この再構築で独自に追加した旨を明記した再現要素です）。

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドとしても実行できます：

npx @reneturcios/jobfeed jobs_get_board '{"ats":"ashby","slug":"ramp"}'
npx @reneturcios/jobfeed jobs_find_board '{"company":"ramp.com"}'
npx @reneturcios/jobfeed jobs_search_by_location '{"locations":["Costa Mesa"],"descriptionIncludes":["avionics"]}'
npx @reneturcios/jobfeed --version

終了コード：成功時は 0、isError の結果時は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/jobfeed mcp

MCP クライアントの設定：

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

Docker

docker run -i ghcr.io/cloudcorprecords/jobfeed
docker run --rm ghcr.io/cloudcorprecords/jobfeed --version

コンテナのデフォルトコマンドは mcp なので、最初の形式は stdio MCP サーバーとして 動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべてスタブ化された JSON-RPC 上流環境で実行されます。ライブネットワークへの呼び出しはありません。

ライセンス

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