Английский язык

##английский

**MCP (Model Context Protocol) сервер для интеграции API HeadHunter с Claude Code и другими MCP-клиентами.

HeadHunter (hh.ru) — крупнейшая платформа поиска работы в России и странах СНГ. Этот MCP-сервер обеспечивает бесшовную интеграцию с API HeadHunter, позволяя помощникам ИИ искать вакансии, управлять резюме и подавать заявки на вакансии от вашего имени.

Особенности

** Расширенный поиск вакансий** - фильтр по местоположению, зарплате, опыту, типу занятости Управление резюме - Просмотр и управление резюме HeadHunter

• ️ ** Заявки на работу** - Применять вакансии с заказными сопроводительными письмами ** Информация о компании** - Получить подробные данные о работодателе ** Отслеживание приложений** - отслеживайте историю ваших заявлений на работу AI-Powered Agent - Автоматизированный охотник за вакансиями с интеллектуальным сопоставлением 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"
      }
    }