Headhunter MCP

HeadHunter MCP服务器

   

英语 | 俄语

______________________________________________________________________

英语

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

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

特性

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

可用工具（10）

1. hh_search_空缺 -搜索职位空缺
2. hh_get_职位空缺 -获取详细的职位空缺信息
3. hh_get_雇主 -获取公司/雇主详细信息
4. hh_get_相似 -查找类似职位空缺
5. hh_get_区域 -获取地区/城市列表
6. hh_get_字典 -获取参考数据（经验、就业类型等）
7. hh_get-resumes -获取您的简历列表
8. hh_get_resume -获取详细的简历信息
9. hh_申请_取消 -申请职位空缺（需要OAuth）
10. hh_get谈判 -获取应用程序历史记录（需要OAuth）

快速开始

1.安装

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.获取HeadHunter API证书

1. 在以下网址注册您的申请 https://dev.hh.ru/admin
2. 获取客户端ID、客户端密码和应用令牌
3. 复制 .env.example 到 .env 并填写您的凭据

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

3.配置克劳德代码

添加到您的 ~/.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"
      }
    }
  }
}

4.OAuth授权（可选）

对于工作申请和简历管理：

python examples/oauth_flow.py

按照说明授权并获取访问令牌。

用法示例

# Search for Python jobs in Moscow
Find 10 Python developer vacancies in Moscow with salary from 200000

# View your resumes
Show my resumes

# Get vacancy details
Show details for vacancy 126209046

# Apply to a job (after OAuth)
Apply to vacancy 126209046 with resume [resume_id] and cover letter: "Hello..."

招聘代理

用于智能空缺搜索和分析的自动化代理。看 docs/vacancy-hunter-agent.md 了解详情。

特征：

• 同时分析多份简历
• 按相关性对空缺职位进行评分（0-30分）
• 生成带有人工智能建议的CSV报告
• 仅关注莫斯科地区

用途：

Run vacancy-hunter agent

项目结构

headhunter-mcp-server/
├── server.py              # MCP server (10 tools)
├── hh_client.py           # HeadHunter API client
├── requirements.txt       # Python dependencies
├── .env.example           # Environment variables template
├── examples/
│   └── oauth_flow.py      # OAuth authorization script
└── docs/
    └── vacancy-hunter-agent.md  # Agent documentation

需求

• Python 3.10+
• Claude Code或任何兼容MCP的客户端
• HeadHunter API证书

贡献

欢迎投稿！请随时提交拉取请求。

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

链接

• HeadHunter API文档
• 模型上下文协议
• Claude代码文档

______________________________________________________________________

俄语

用于将Headhunter API与Claude Code和其他MCP客户端集成的MCP服务器。

Headhunter（HH.RU）是俄罗斯和独联体国家最大的求职平台。该MCP服务器与Headhunter API无缝集成，允许AI助理搜索空缺，管理简历并代表您响应空缺。

机会

• 🔍 高级职位搜索 -按位置、工资、经验、就业类型进行过滤
• 📄 摘要管理 -在Headhunter上查看和管理简历
• ✉️ 对空缺的反应 -使用个性化的送文函提交申请
• 🏢 公司信息 -获取雇主详细信息
• 📊 响应跟踪 -监控您的响应历史记录
• 🤖 AI代理 -自动搜索空缺与智能匹配
• 🔐 OAuth 2.0 -通过Headhunter安全授权

可用工具（10）

1. hh_search_空缺 -寻找空缺
2. hh_get_职位空缺 -空缺详细信息
3. hh_get_雇主 -公司/雇主信息
4. hh_get_相似 寻找类似的职位
5. hh_get_区域 -地区/城市列表
6. hh_get_字典 -背景资料（经验、就业类型等）
7. hh_get-resumes -简历列表
8. hh_get_resume -关于简历的详细信息
9. hh_申请_取消 -响应空缺（需要OAUTH）
10. hh_get谈判 -响应历史记录（需要OAuth）

快速启动

1.安装

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

2.获取Credentials Headhunter API

1. 注册应用程序 https://dev.hh.ru/admin
2. 获取客户端ID、客户端秘密和应用令牌
3. 复制 .env.example 在 .env 填写您的凭据

cp .env.example .env
# Отредактируйте .env своими credentials

3.设置Claude Code

添加到 ~/.claude.json:

{
  "mcpServers": {
    "headhunter": {
      "type": "stdio",
      "command": "/путь/к/venv/bin/python",
      "args": ["/путь/к/headhunter-mcp-server/server.py"],
      "env": {
        "HH_CLIENT_ID": "ваш_client_id",
        "HH_CLIENT_SECRET": "ваш_client_secret",
        "HH_APP_TOKEN": "ваш_app_token",
        "HH_REDIRECT_URI": "https://ваш-домен.com/oauth/callback"
      }
    }
  }
}

4.OAuth授权（可选）

为了响应空缺和管理简历：

python examples/oauth_flow.py

按照说明授权和获取访问令牌。

使用示例

# Поиск Python вакансий в Москве
Найди 10 вакансий Python разработчика в Москве с зарплатой от 200000

# Просмотр резюме
Покажи мои резюме

# Детали вакансии
Покажи детали вакансии 126209046

# Отклик на вакансию (после OAuth)
Откликнись на вакансию 126209046 резюме [resume_id] с письмом: "Здравствуйте..."

招聘代理

自动代理智能搜索和分析空缺。详细信息 docs/vacancy-hunter-agent.md.

机会：

• 同时分析多个简历
• 评估空缺的相关性（0-30分）
• 生成带有AI建议的CSV报告
• 只关注莫斯科地区

用途：

Запусти агента vacancy-hunter

项目结构

headhunter-mcp-server/
├── server.py              # MCP сервер (10 инструментов)
├── hh_client.py           # HeadHunter API клиент
├── requirements.txt       # Python зависимости
├── .env.example           # Шаблон переменных окружения
├── examples/
│   └── oauth_flow.py      # Скрипт OAuth авторизации
└── docs/
    └── vacancy-hunter-agent.md  # Документация агента

要求

• Python 3.10+
• Claude Code或任何与MCP兼容的客户端
• HeadHunter API证书

参与制定

欢迎任何贡献！不要犹豫发送pull request。

许可证

MIT许可证-文件中的详细信息 许可证.

参考文献

• Headhunter API文档
• 模型上下文协议
• Claude Code文档

______________________________________________________________________

由以下材料制成❤️ HeadHunter和MCP社区