Recruiter Roles — Recruiter & Talent Acquisition Jobs MCP Server

Recruiter Roles MCP サーバー

あらゆるMCP対応AIクライアント（Claude、Cursor、ChatGPT、VS Code、…）からRecruiter Rolesの求人ボードを検索できます。自然な言葉で質問すると、求人ボードから最新のリクルーターおよびタレントアクイジションの求人、企業プロフィール、業界、勤務地、市場統計を直接取得できます。

読み取り専用です。無料のRecruiter Roles APIキーで認証します。

• ホスト型（推奨）： https://recruiterroles.com/api/mcp（Streamable HTTP）
• ローカル（このパッケージ）： npx recruiter-roles-mcp（stdio、stdioのみ対応するクライアント向け）
• 無料のAPIキーを取得： https://recruiterroles.com/api-access
• ドキュメント： https://recruiterroles.com/mcp · REST API： https://recruiterroles.com/api-docs

ツール

ツール	説明
search_jobs	最新の求人を検索・絞り込みます（業界、勤務地、給与、リモート、掲載時期、全文検索）。
get_job	1件の求人の詳細を取得します — 説明、応募要件、福利厚生、応募先。
list_companies	求人掲載中の人材紹介会社と雇用主を、アクティブな求人件数とともに一覧表示します。
get_company	企業プロフィールと、その企業のアクティブな求人を取得します。
list_sectors	最新の求人件数を含む、すべての人材採用業界を一覧表示します。
list_locations	最新の求人件数を含む、国、地域、都市を一覧表示します。
market_stats	市場全体の概要を取得します — 合計、求人掲載の推移、内訳。

すべてのツールには readOnlyHint: true、destructiveHint: false、openWorldHint: false の注釈が付けられ、outputSchema が公開されています。

接続

ホスト型リモートサーバー（推奨）

ほとんどのクライアントは、Authorization ヘッダーにAPIキーを指定して、ホスト型のStreamable HTTPエンドポイントに直接接続できます（ヘッダーを設定できないクライアントでは、クエリパラメーター ?key= として指定できます）。

Cursor — ~/.cursor/mcp.json：

{
  "mcpServers": {
    "recruiter-roles": {
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

VS Code — .vscode/mcp.json：

{
  "servers": {
    "recruiter-roles": {
      "type": "http",
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

Claude / ChatGPTのカスタムコネクタ — キーを末尾に追加したURLを指定します：

https://recruiterroles.com/api/mcp?key=rr_live_YOUR_KEY

ローカルstdioサーバー（このnpmパッケージ）

stdioのみ対応するクライアントやローカル開発向けです。RECRUITER_ROLES_API_KEY 環境変数でAPIキーを設定します。

{
  "mcpServers": {
    "recruiter-roles": {
      "command": "npx",
      "args": ["-y", "recruiter-roles-mcp"],
      "env": { "RECRUITER_ROLES_API_KEY": "rr_live_YOUR_KEY" }
    }
  }
}

直接実行する場合：

RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY npx recruiter-roles-mcp

仕組み

これは、公開されているRecruiter Roles v1 REST APIの読み取り専用の薄いレイヤーです。各ツールはAPIキーを1つの GET /api/v1/* エンドポイントに転送するため、MCPの利用にはREST APIと同じレート制限（キーごとに1日1,000リクエスト）、キャッシュ、リクエストログが適用されます。サーバーはデータベース接続を保持せず、独自のシークレットも保持しません。

開発

npm install
npm run build
RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY node dist/index.js

任意：開発中に RECRUITER_ROLES_BASE_URL を使って別のオリジンを指定できます（デフォルトは https://recruiterroles.com）。

バックリンクポリシー

このサーバーから取得したデータを公開するページや製品には、Recruiter Rolesへの、目視でき、クローラーがたどれるリンクを必ず含めてください。バックリンクが削除された場合、キーが停止されることがあります。

ライセンス

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