Unified Jobs MCP Server

Unified Jobs MCP Server

AI エージェントに、単一ソースの求人検索ツールではできないことを実現する、依存関係ゼロのModel Context Protocolサーバーです。複数のソースから求人情報を取得し、重複を排除したフィードを提供します。応募者追跡システム、LinkedIn の公開ゲスト検索、Hacker News の 「Who is hiring?」 スレッドを検索し、複数のソースに掲載されている同じ職種を1件の正規レコードに統合します。sources[] 配列に加え、最も充実した給与情報、最も長い説明、最も早い投稿日をまとめます。エージェントは、重複する3つのリストと重複排除の手間の代わりに、整理されたリストを取得できます。

• API キー不要、アカウント不要、ログイン不要。 すべてのデータは、キー不要の公開エンドポイントから取得されます。
• 依存関係ゼロ。 標準に準拠した JSON-RPC 2.0 を stdio 上で独自に実装しているため、SDK は不要で、エージェントの信頼境界内に推移的なパッケージツリーも持ち込みません。npx ですぐにインストールして起動できます。
• 公開求人のみ。 会員データはなく、PII も公開求人情報の範囲に限られます。

インストール

Claude Desktop（claude_desktop_config.json）／Cursor／Cline／Continue：

{
  "mcpServers": {
    "unified-jobs": {
      "command": "npx",
      "args": ["-y", "github:rezearcher/unified-jobs-mcp"]
    }
  }
}

または、直接実行します：

npx -y github:rezearcher/unified-jobs-mcp

ツール

search_unified_jobs

複数ソースを横断する求人フィードです。1回の呼び出しで、1社以上の企業の ATS 求人情報（companies[]）、LinkedIn（keywords + location）、および現在の HN スレッドを検索し、重複のないリストを取得できます。複数のソースに掲載されている同じ職種は、1件のレコードに統合されます：

{
  "title": "Backend Software Engineer - Infrastructure",
  "company": "Palantir",
  "location": "United States",
  "salary": "$135,000 - $200,000 / yr",
  "posted_at": "2026-10-14T00:00:00.000Z",
  "sources": [
    { "source_platform": "lever",    "url": "https://jobs.lever.co/palantir/..." },
    { "source_platform": "linkedin", "url": "https://www.linkedin.com/jobs/view/..." }
  ],
  "primary_url": "https://jobs.lever.co/palantir/...",
  "merged": true
}

結果セットごとに、重複排除の統計情報 raw_source_hits、canonical_jobs、cross_source_merges、collapsed、per_source_hits が報告されます。

フィールド	説明
companies	ATS 企業：スラッグ（"stripe"）、ドメイン（"stripe.com"）、または "platform:token"（"lever:palantir"、"workday:tenant.wd5:Site"）。スラッグやドメインの場合、ATS とトークンは自動検出されます。
keywords, location	LinkedIn の検索（keywords は HN の絞り込みにも使用されます）。
sources	["ats","linkedin","hn"] のサブセット。デフォルトは3つすべてです。
maxPerSource	統合前の、ソースごとの行数上限（デフォルトは25、最大200）。
maxResults	統合後の正規レコード数の上限（任意）。
remoteOnly, dedupe, includeDescription	ブール値。dedupe はデフォルトで有効です。

search_hn_hiring

今月の Hacker News 「Ask HN: Who is hiring?」 スレッドのみを対象とし、同じスキーマに正規化します。月次スレッド ID は自動検出され（毎月1日に更新されます）、自由記述の各投稿ヘッダーは構造化フィールドに解析されます。query と remoteOnly で絞り込むこともできます。

list_sources

ソースの種類、ATS 企業の指定方法、ソース間の重複排除の仕組みを確認できます。ネットワーク呼び出しは行いません。

ソース

種類	対応範囲	キー不要
ats	Greenhouse、Lever、Ashby、SmartRecruiters、Workday、Recruitee、Workable	✅
linkedin	公開ゲスト向け求人検索（キーワード + 場所）	✅（クラウド IP ではレート制限があるため、利用可能な範囲に制限されます）
hn	「Who is hiring?」 の当月スレッド	✅

各ソースは個別に処理されるため、1つのソースで障害が発生しても（例：LinkedIn のゲスト用エンドポイントがクラウド IP をレート制限しても）、呼び出し全体が失敗することはありません。応答があったソースの結果を取得できます。ホスト型の従量課金版では、Indeed とローテーションする住宅用プロキシが追加され、より多くの求人を取得できます。

重複排除の仕組み

• 正規キー： company | title | city。法的な企業名の接尾辞は除去しますが、シニアレベルと職種の修飾語は維持するため、Backend - Infrastructure と Backend - Defense は別々の職種として扱われます。
• 統合： スカラー値はソースの優先順位に従い、最初に見つかった null 以外の値を使用します。給与情報は、最も充実した単一のソースから全体を取得して整合性を維持します。posted_at は最も早い日付、説明は最も長いものが使われ、すべての提供元が sources[] に追加されます。
• 利用可能な範囲で処理： キーを導出できない行は、merged: false の独立したレコードとして出力され、黙って破棄されることはありません。

メンテナンス

GitHub Actions のスモークワークフローは、実際の MCP クライアントとのハンドシェイクと、ソースをまたいだライブデータの取得を、プッシュのたびと毎日実行します。ATS と HN の各ファミリーがゲートとなり、LinkedIn は参考扱いです（クラウド IP のレート制限があるためです）。上流で実際にデータ形式が変更されると、ラウンドトリップが失敗し、追跡用の Issue が自動的に作成されます。フィードは機能し続けるよう保守され、放置されることはありません。

ライセンス

MIT © Grey Ridge Signals Group LLC