英文 |Русский

---

英语

MCP（模型上下文协议）服务器，用于将HeadHunter API与Claude代码及其他MCP客户端集成。

HeadHunter（hh.ru）是俄罗斯及独联体国家最大的求职平台。该MCP服务器与HeadHunter API无缝集成，使AI助理能够代表您搜索职位空缺、管理简历并申请职位。

特色

• 🔍 高级职位搜索 - 按地点、薪资、经验、雇佣类型筛选
• 📄 简历管理 - 查看和管理您的HeadHunter简历
• ✉️ 求职申请 - 使用定制求职信申请空缺
• 🏢 公司信息 - 获取详细雇主数据
• 📊 申请跟踪 - 监控你的求职历史
• 🤖 AI驱动代理 - 自动空缺猎人，具智能匹配功能
• 🔐 OAuth 2.0 - 通过HeadHunter实现安全授权

可用工具（10）

1. hh_search_vacancies - 寻找职位空缺
2. hh_get_vacancy - 获取详细的空缺信息
3. hh_get_employer - 获取公司/雇主的详细信息
4. hh_get_similar - 寻找类似的空缺
5. hh_get_areas - 获取地区/城市列表

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"
      }
    }