한국어 | Русский

---

한국어

**MCP (Model Context Protocol) Claude Code 및 기타 MCP 클라이언트와 HeadHunter API를 통합하기위한 서버. **

HeadHunter (hh.ru)는 러시아와 CIS 국가에서 가장 큰 구직 플랫폼입니다. 이 MCP 서버는 HeadHunter API와 원활한 통합을 제공하며, AI Assistant를 사용하여 vacancies를 검색하고 이력서를 관리하고 대신 작업에 적용합니다.

특징

• logist Advanced Vacancy Search - 위치, 급여, 경험, 고용 유형의 필터
• Resume Management - HeadHunter의 이력서 및 관리
• JIANG️ **Job 응용 프로그램 ** - 사용자 정의 커버 레터를 사용하여 예방 접종
• **회사 정보 ** - 상세한 고용주 데이터를 얻으십시오
• ** 신청 추적 ** - 작업 응용 프로그램 역사를 모니터링
• 덧붙여진 AI-Powered Agent - 지능형 매칭을 가진 자동화된 공병 사냥꾼
• OAuth 2.0** - HeadHunter의 보안 인증

유효한 공구 (10)

1.hh search vacancies - 구직 활동 2. hh get vacancy - 자세한 정보를 얻으십시오 3. ** hh get employer** - 회사/employer 세부 정보 얻기 4. ** hh get similar** - 유사한 백신을 찾으십시오 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"
      }
    }