hh.ru API 用の MCP サーバー — ロシアおよび CIS の求人市場。19 のツール が、求人、履歴書、企業、給与統計、辞書、オートコンプリート、トークン診断をカバーします。
レスポンスはデフォルトでコンパクトで LLM に優しい要約として返されます。任意の検索・詳細ツールに raw: true を渡すと、完全な hh.ru JSON を取得できます。
Russian API MCP シリーズの一部です。@theYahia によるものです。
モード | 利用可能なもの | トークンが必要? |
トークンなし | 求人検索、求人IDによる取得、類似求人、企業、給与統計、エリア、役割、業界、地下鉄、辞書、サジェスト、トークンチェック | いいえ |
トークンあり | 上記すべて + 履歴書検索、履歴書IDによる取得 | はい ( |
トークンは dev.hh.ru/admin で取得できます。注意: 履歴書検索にはさらに employer アカウントと 有料の履歴書データベース購読 が必要です。応募者・匿名トークンは 403 になります。validate_token を使用して、トークンで何ができるかを確認してください。
Related MCP server: laddro-career-mcp
{
"mcpServers": {
"hh": {
"command": "npx",
"args": ["-y", "@theyahia/hh-mcp"],
"env": {
"HH_ACCESS_TOKEN": "optional-oauth-token"
}
}
}
}claude mcp add hh -- npx -y @theyahia/hh-mcp
# With token:
claude mcp add hh -e HH_ACCESS_TOKEN=your-token -- npx -y @theyahia/hh-mcp{
"servers": {
"hh": {
"command": "npx",
"args": ["-y", "@theyahia/hh-mcp"]
}
}
}{
"mcpServers": {
"hh": {
"command": "npx",
"args": ["-y", "@theyahia/hh-mcp"]
}
}
}npx @theyahia/hh-mcp --http
# or
HTTP_PORT=8080 npx @theyahia/hh-mcp --httpエンドポイント: http://localhost:3000/mcp (POST) · ヘルスチェック: http://localhost:3000/health (GET)
HTTP モードはステートレスで、デフォルトでは 127.0.0.1 にバインドされ、DNS リバインディング保護が有効です。公開するには、HOST=0.0.0.0 を設定し、ホスト/オリジンを HH_ALLOWED_HOSTS / HH_ALLOWED_ORIGINS に追加し、独自の認証の背後に置いてください。
変数 | 必須 | 説明 |
| いいえ | OAuth 2.0 Bearer トークン。履歴書エンドポイントに必要 (employer + 有料履歴書DB)。 |
| いいえ | カスタム |
| いいえ | HTTP モードのポート (デフォルト: 3000)。 |
| いいえ | HTTP モードでバインドするインターフェース (デフォルト: |
| いいえ | HTTP モードの Host 許可リスト (カンマ区切り、デフォルト: loopback)。 |
| いいえ | HTTP モードの Origin 許可リスト (カンマ区切り)。 |
.env.example を参照してください。
すべての検索・詳細ツールは raw: true を受け付け、コンパクトな要約の代わりに完全な hh.ru JSON を返します。
ツール | 説明 | トークン? |
| キーワード、地域、専門職ロール、業界、地下鉄、企業、給与、経験、勤務形態 / 雇用形態、日付範囲 ( | いいえ |
| 求人の詳細: 説明、要件、主要スキル、連絡先。 | いいえ |
| 指定した求人に類似した求人を検索。 | いいえ |
ツール | 説明 | トークン? |
| キーワード、地域、ロール、給与、経験による候補者の履歴書検索。 | はい |
| 完全な履歴書: 経験、学歴、スキル、連絡先。 | はい |
ツール | 説明 | トークン? |
| 名前と地域による企業検索。 | いいえ |
| 企業プロフィール: 説明、業界、ウェブサイト、求人件数。 | いいえ |
| 特定の企業のアクティブな求人一覧。 | いいえ |
ツール | 説明 | トークン? |
| 地域と都市のツリー ( | いいえ |
| 1つのエリアIDの下の地域/都市 — 完全なツリーより軽量。 | いいえ |
| ID付きの専門職ロールのツリー。 | いいえ |
| ID付きの企業業界のツリー。 | いいえ |
| 都市の地下鉄駅/路線とID。 | いいえ |
| すべての参照データ: 通貨、雇用形態、勤務スケジュール、経験、ラベル。 | いいえ |
| 職種名のオートコンプリート。 | いいえ |
| 企業名のオートコンプリート。 | いいえ |
| 地域/都市名のオートコンプリート。 | いいえ |
ツール | 説明 | トークン? |
| 推定 給与分布 (中央値、P25/P75、最小/最大) を、地域内のロールについて、掲載された求人給与から計算。偏ったサンプルであり、公式の市場データではありません。 | いいえ |
|
| いいえ |
組み込みのレートリミッターは、hh.ru API の1秒あたり5リクエストの制限を尊重します。429 および 5xx エラー時には指数バックオフで自動再試行します (最大3回)。注意: リミッターはプロセス全体で共有されるため、共有 HTTP モードではすべてのクライアントが1つの 5 req/s の予算を共有します。
Find remote Python developer jobs in Moscow paying over 300,000 RUBShow me all open vacancies at Yandex and give me salary statistics for their top rolesCompare Senior Backend salaries in Moscow vs Saint Petersburg, and suggest similar vacancies to the best-paying onegit clone https://github.com/theYahia/hh-mcp.git
cd hh-mcp
npm install
npm run build
npm testMIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
YouTube transcripts, search, channels, playlists and bulk transcript jobs for AI agents. 14 tools.
Hire real humans for tasks agents can't do alone. 36 tools for the full hiring lifecycle.
Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/hh-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server