HeadHunter MCP Server
MCP-сервер API hh.ru для соискателя: поиск вакансий, данные работодателей, свои резюме и отклики с сопроводительным письмом
- 32 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Отправляет отклики на вакансии от имени пользователя
- Читает резюме с персональными данными
- Хранит секреты приложения и OAuth-токены
Установка
- Работает в
- Сервисы
Ручная установка
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .envВыполнять в клоне репозитория gmen1057/headhunter-mcp-server.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Отправляет отклики на вакансии от имени пользователя
- Читает резюме с персональными данными
- Хранит секреты приложения и OAuth-токены
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к API HeadHunter. Без авторизации пользователя агент ищет вакансии с фильтрами по городу, зарплате, опыту и занятости, открывает вакансию и похожие на нее, получает сведения о работодателе, регионы и справочники. После OAuth-авторизации он читает резюме пользователя, историю откликов и откликается на вакансии с сопроводительным письмом. В репозитории описан отдельный сценарий агента, который сопоставляет вакансии с несколькими резюме, оценивает их и сохраняет отчет в CSV.
Для кого. Для соискателей и карьерных консультантов, которые ищут работу через hh.ru.
Подходит, если
- Нужно отобрать вакансии по нескольким критериям и сравнить их с резюме
- Нужно быстро посмотреть работодателя и похожие вакансии
- Нужно отправить отклик с письмом, написанным под конкретную вакансию
Не подходит, если
- Нужна работа со стороны работодателя: поиск резюме и управление вакансиями
- Не хотите, чтобы агент отправлял отклики от вашего имени без проверки
Пример запроса к агенту
Найди 10 вакансий Python-разработчика в Москве с зарплатой от 200 000 и покажи, какие лучше подходят под мое резюмеMCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
HH_CLIENT_IDобязательная- Client ID приложения на dev.hh.ru
HH_CLIENT_SECRETобязательная, секрет- Client Secret приложения
HH_APP_TOKENобязательная, секрет- Токен приложения
HH_REDIRECT_URI- Адрес возврата для OAuth
Ограничения
Нужно зарегистрировать приложение на dev.hh.ru и получить Client ID, Client Secret и токен приложения. Отклики и резюме доступны только после OAuth-авторизации с адресом возврата. Публичная спецификация hh.ru не содержит методов соискателя для чтения собственных резюме и создания откликов, поэтому эти инструменты сервера могут не работать, проверьте их до использования. Пакета нет, сервер ставится из клона в виртуальное окружение Python; сценарий подбора вакансий рассчитан только на Москву.
Как отключить. Удалите блок headhunter из ~/.claude.json и отзовите доступ приложения в настройках аккаунта hh.ru.
Частые вопросы
Можно ли искать вакансии без OAuth?
Да, поиск, вакансии, работодатели и справочники работают с данными приложения. OAuth нужен для резюме, откликов и истории откликов.
Подойдет ли для рекрутера?
Нет, инструменты рассчитаны на соискателя: поиска резюме и управления вакансиями работодателя в сервере нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
hh.ru — все инструментыMCP-сервер для работодательской части API hh.ru и hh.kz: свои вакансии, отклики, поиск резюме, сорсинг и вебхуки через OAuth-приложение
hh.ru MCP
hh-mcp
MCP-сервер для API hh.ru: поиск вакансий и работодателей, оценка зарплат, справочники, резюме при доступе работодателя
MCP-сервер поиска работы на hh.ru через браузер: рекомендованные вакансии по резюме, отклики и статусы
MCP-сервер на cookie-сессии, который дает агенту поиск, отклики, переписку и скрытую аналитику резюме на hh.ru, без официального API
ats-mcp-server: вакансии из hh.ru и систем найма
ats-mcp-server
MCP-сервер, который собирает вакансии из hh.ru и публичных API Greenhouse, Ashby, Lever, Workable и Bayt в едином формате без парсинга HTML
MCP-сервер с 52 инструментами по официальному API hh.ru: поиск вакансий без токена, резюме и отклики работодателя с токеном, статистика зарплат
Коротко о README
README на английском и русском перечисляет десять инструментов и ведет по установке: клонирование, виртуальное окружение, регистрация приложения на dev.hh.ru и блок конфигурации для Claude Code. Отдельно описан скрипт OAuth-авторизации для откликов и сценарий агента для подбора вакансий. Лицензия MIT.