HeadHunter MCP Server
MCP-сервер API hh.ru для соискателя: поиск вакансий, данные работодателей, свои резюме и отклики с сопроводительным письмом
Установка
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .envВыполнять в клоне репозитория gmen1057/headhunter-mcp-server.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к API HeadHunter. Без авторизации пользователя агент ищет вакансии с фильтрами по городу, зарплате, опыту и занятости, открывает вакансию и похожие на нее, получает сведения о работодателе, регионы и справочники. После OAuth-авторизации он читает резюме пользователя, историю откликов и откликается на вакансии с сопроводительным письмом. В репозитории описан отдельный сценарий агента, который сопоставляет вакансии с несколькими резюме, оценивает их и сохраняет отчет в CSV.
Для кого. Для соискателей и карьерных консультантов, которые ищут работу через hh.ru.
Подходит, если
- Нужно отобрать вакансии по нескольким критериям и сравнить их с резюме
- Нужно быстро посмотреть работодателя и похожие вакансии
- Нужно отправить отклик с письмом, написанным под конкретную вакансию
Не подходит, если
- Нужна работа со стороны работодателя: поиск резюме и управление вакансиями
- Не хотите, чтобы агент отправлял отклики от вашего имени без проверки
Пример запроса к агенту
Найди 10 вакансий Python-разработчика в Москве с зарплатой от 200 000 и покажи, какие лучше подходят под мое резюмеОграничения
Нужно зарегистрировать приложение на dev.hh.ru и получить Client ID, Client Secret и токен приложения. Отклики и резюме доступны только после OAuth-авторизации с адресом возврата. Пакета нет, сервер ставится из клона в виртуальное окружение Python; сценарий подбора вакансий рассчитан только на Москву.
Как отключить. Удалите блок headhunter из ~/.claude.json и отзовите доступ приложения в настройках аккаунта hh.ru.
MCP
- Транспорт
- stdio
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| HH_CLIENT_ID обязательная | Client ID приложения на dev.hh.ru |
| HH_CLIENT_SECRET обязательная, секрет | Client Secret приложения |
| HH_APP_TOKEN обязательная, секрет | Токен приложения |
| HH_REDIRECT_URI | Адрес возврата для OAuth |
Проверка безопасности
- Отправляет отклики на вакансии от имени пользователя
- Читает резюме с персональными данными
- Хранит секреты приложения и OAuth-токены
Коротко о README
README на английском и русском перечисляет десять инструментов и ведет по установке: клонирование, виртуальное окружение, регистрация приложения на dev.hh.ru и блок конфигурации для Claude Code. Отдельно описан скрипт OAuth-авторизации для откликов и сценарий агента для подбора вакансий. Лицензия MIT.
Частые вопросы
Можно ли искать вакансии без OAuth?
Да, поиск, вакансии, работодатели и справочники работают с данными приложения. OAuth нужен для резюме, откликов и истории откликов.
Подойдет ли для рекрутера?
Нет, инструменты рассчитаны на соискателя: поиска резюме и управления вакансиями работодателя в сервере нет.
Похожие
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Официальные плагины Anthropic для офисных ролей: продажи, поддержка, продукт, маркетинг, юристы, финансы, данные и поиск по компании