hiringindex-mcp

hiringindex-mcp

最新の求人情報を扱う MCP サーバーです。職種を検索し、市場の一部を集計して、各求人がどれくらいの期間掲載されているかを確認できます。

依存関係なし、Node ≥ 18、stdio トランスポート。

インストール

npx -y hiringindex-mcp

まずキーを取得してください。無料です。 BASIC プランは月額 0 ドルで、求人情報を 200 件、インサイトを 5 件利用できます。https://rapidapi.com/starnikovoleg/api/hiringindex/pricing から登録し、以下の HIRINGINDEX_API_KEY にキーを設定してください。

Claude Desktop / Claude Code：

{
  "mcpServers": {
    "hiringindex": {
      "command": "npx",
      "args": ["-y", "hiringindex-mcp"],
      "env": { "HIRINGINDEX_API_KEY": "your-key" }
    }
  }
}

ツール

ツール	回答できる質問
search_jobs	「アムステルダムで、給与が 8 万を超える Python データ職を見せて」
job_market_insights	「ベルリンのデータエンジニアの給与はいくらで、どの企業が採用している？」
posting_age_report	「これらの求人は新しい？ それとも数か月間掲載されている？」
get_job	「この ID の求人情報をすべて表示して」

posting_age_report は掲載期間の中央値、今週掲載された求人の割合、60 日を過ぎても掲載中の求人の割合を報告します。最後の割合は、その職種が積極的に採用されていないことを示すものとして、最もよく引用される指標です。数値を報告するものであり、雇用主の意図を知っているかのように装うことはありません。

既存のツールとの違い。 無料ツールの whenthisjobwasposted.com は、一度に 1 つの URL について実際の掲載日を特定し、独自の MCP サーバーも提供しています。それが必要な場合は、そちらをご利用ください。無料です。このツールは別の質問に答えます。同じコホートについて、給与や需要と合わせて算出した、市場全体の一部における掲載期間の分布です。一方は個別検索、もう一方は集計です。

4 つのツールすべてで同じフィルター形式を使用するため、一度定義した条件で、クエリを書き直すことなく検索、集計、掲載期間の分析ができます。

フィルター

ライブインデックスで適用できるフィルターは以下のとおりです（2026-09-07 にマーケットプレイスの掲載情報と照合済み。board_handle は 2026-09-08 に追加）。それ以外はフィルターではありません。また、ツールスキーマは固定されているため、モデルが存在しないフィルターを作り出すことはできません。

フィールド	意味	備考
titles	照合する職種名	3 文字未満の語句はインデックスで拒否されます
keywords	求人情報内（職種名または説明文）に記載された語句	いずれかのキーワードが一致します。2026-09-08 以降の仕様です。それ以前は職種名のみが対象でした
city	雇用主が表記する都市名	"Berlin"、"New York"、"Bengaluru"
country	ISO 3166-1 alpha-2 コードまたは英語名	"US"、"Germany"。名前はローカルでコードに変換されます
work_arrangement	Remote / In Person	ハイブリッドは上流側で個別のフィルターとして扱われません
company	雇用主 1 社の名前
board_handle	ハンドルで指定する ATS ボード 1 つ	求人情報の handle フィールドから取得します。例："EndeavorITSolution"、"walmart:wd504:WalmartExternal"
salary_min / salary_max	公開されている給与の下限・上限	給与を公開している求人情報のみ一致します
posted_within_days	過去 N 日以内に公開された求人
page / limit	ページ指定。limit は最大 100	search_jobs のみ

インデックスでは受け付けられますが、ここでは提供していないフィルター：seniority と employment_type。値がベンダー固有の文字列（"Mid-Senior Level"、"FullTime"）であるため、モデルが表記を推測して、結果として何も得られない可能性があります。集計では、雇用主による表記のまま両方を報告します。上流側でそもそも利用できないもの：地域または州、業界。

設定

変数	デフォルト	意味
HIRINGINDEX_API_KEY	—	必須。RAPIDAPI_KEY も使用できます。無料の BASIC プラン：https://rapidapi.com/starnikovoleg/api/hiringindex/pricing
HIRINGINDEX_HOST	hiringindex.p.rapidapi.com	マーケットプレイスのホスト
HIRINGINDEX_API_BASE	—	マーケットプレイスの代わりに、バックエンドを直接呼び出す場合に設定します
HIRINGINDEX_TIMEOUT_MS	30000	リクエストのタイムアウト

HIRINGINDEX_API_BASE を設定すると、認証方式が x-rapidapi-key から x-api-key に切り替わり、マーケットプレイスを経由しなくなります。

ハンドシェイクをローカルで行う理由

ツールはリモートの /mcp をプロキシするのではなく、REST エンドポイントを直接呼び出します。 マーケットプレイスでは、initialize と tools/list も含め、宣言されたパスへのリクエストごとに課金されます。このパッケージを経由すれば、ハンドシェイクがマシンの外に出ることはなく、実際のクエリだけが課金対象になります。

出力

デフォルトでは Markdown です。同じ項目が繰り返される場合は表として表示されるため、ラベル付きのリストよりトークンを節約でき、人にも読みやすい形式です。任意のツールに format: "json" を渡すと、生のレスポンスを取得できます。

開発

npm test          # 16 protocol checks, no key needed
HIRINGINDEX_API_KEY=... npm test   # 17 — adds live calls through the marketplace

テストでは、実際のクライアントと同じ方法でサーバーを動作させ、JSON-RPC を標準入力に書き込み、標準出力から読み取ります。

公開前

1. 実際のキーでスモークテストを行います。2026-09-07 にマーケットプレイス経由で実施済みで、17/17 件でした（検索、インサイト、年齢レポート、単一求人）。公開のたびに再実行してください。
2. git init を実行し、package.json に repository を追加します。
3. マーケットプレイスのホストは確定済み（hiringindex.p.rapidapi.com、2026-09-07 から公開掲載）なので、config.js のデフォルト値を変更するためにメジャーバージョンを上げる必要はありません。
4. 公式 MCP レジストリ（ゲートキーパーなし）に申請し、その後 Docker MCP Registry と Cline マーケットプレイスにも申請します。

レジストリ掲載に関する注意

公式レジストリにある求人関連サーバー 115 件の中で、閲覧するユーザーが読むのは説明だけです。インストールされるのは、国、業界、単一の職種など、対象が絞られたものです。「AI による求人検索」では、他の十数件と見分けがつきません。数値、情報源、ツールの一覧を先頭に掲げてください。そして、ほかの誰も取り上げていない年齢という切り口も前面に出してください。