英語 | 可愛

お問い合わせ

##英語

MCP (Model Context Protocol) サーバは、Claude Code や他の MCP クライアントと HeadHunter API を統合します。

HeadHunter(hh.ru)は、ロシアとCIS諸国で最大の求人検索プラットフォームです。 このMCPサーバーは、HeadHunter APIとシームレスな統合を提供し、AIアシスタントがvacanciesを検索したり、履歴書を管理したり、ジョブに代わって適用したりすることができます。

###特徴

• 在留資格上級者検索 - 場所、給与、経験、雇用タイプによるフィルタ
• 同意履歴管理** - HeadHunterの履歴書の表示と管理
• ◦️Jobアプリケーション - カスタムカバー文字でvacanciesに適用
• 会社案内** - 詳細な雇用者データを取得する
• クライアントアプリケーショントラッキング** - ジョブアプリケーション履歴を監視
• ✓AI-Powered Agent** - インテリジェントなマッチングで自動空室ハンター
• 🔐 OAuth 2.0 - HeadHunter の安全な認可

利用できる用具 (10)

1.hh search vacancies - ジョブのvacanciesを検索 2.hh get vacancy - 空室情報の取得 3.hh get employer - 会社/従業員の詳細を取得 4。 hh get similar - 同様のvacanciesを見つける 5.hh get areas - 地域/都市のリストを取得する 6.

HeadHunter MCP Server

English | Русский

---

English

MCP (Model Context Protocol) server for integrating HeadHunter API with Claude Code and other MCP clients.

HeadHunter (hh.ru) is the largest job search platform in Russia and CIS countries. This MCP server provides seamless integration with HeadHunter API, enabling AI assistants to search vacancies, manage resumes, and apply to jobs on your behalf.

Features

• 🔍 Advanced Vacancy Search - Filter by location, salary, experience, employment type
• 📄 Resume Management - View and manage your HeadHunter resumes
• ✉️ Job Applications - Apply to vacancies with custom cover letters
• 🏢 Company Information - Get detailed employer data
• 📊 Application Tracking - Monitor your job application history
• 🤖 AI-Powered Agent - Automated vacancy hunter with intelligent matching
• 🔐 OAuth 2.0 - Secure authorization with HeadHunter

Available Tools (10)

1. hh_search_vacancies - Search for job vacancies
2. hh_get_vacancy - Get detailed vacancy information
3. hh_get_employer - Get company/employer details
4. hh_get_similar - Find similar vacancies
5. hh_get_areas - Get list of regions/cities
6. hh_get_dictionaries - Get reference data (experience, employment types, etc.)
7. hh_get_resumes - Get your resumes list
8. hh_get_resume - Get detailed resume information
9. hh_apply_to_vacancy - Apply to a vacancy (requires OAuth)
10. hh_get_negotiations - Get application history (requires OAuth)

Quick Start

1. Installation

git clone https://github.com/yourusername/headhunter-mcp-server.git
cd headhunter-mcp-server
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

2. Get HeadHunter API Credentials

1. Register your application at https://dev.hh.ru/admin
2. Get Client ID, Client Secret, and App Token
3. Copy .env.example to .env and fill in your credentials

cp .env.example .env
# Edit .env with your credentials

3. Configure Claude Code

Add to your ~/.claude.json:

{
  "mcpServers": {
    "headhunter": {
      "type": "stdio",
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/headhunter-mcp-server/server.py"],
      "env": {
        "HH_CLIENT_ID": "your_client_id",
        "HH_CLIENT_SECRET": "your_client_secret",
        "HH_APP_TOKEN": "your_app_token",
        "HH_REDIRECT_URI": "https://your-domain.com/oauth/callback"
      }
    }