hh-mcp: работодательский API hh.ru и hh.kz
hh-mcp
MCP-сервер для работодательской части API hh.ru и hh.kz: свои вакансии, отклики, поиск резюме, сорсинг и вебхуки через OAuth-приложение
- 1 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Может пригласить кандидата и отправить сообщение от имени работодателя (hh_employer_negotiations invite, message_send)
- Просмотр резюме тратит платный контакт работодателя, ошибка в вызове стоит денег
- OAuth-токены работодателя дают широкий доступ к вакансиям, откликам и резюме кандидатов
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mardanaltynbekov1104-hh-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Может пригласить кандидата и отправить сообщение от имени работодателя (hh_employer_negotiations invite, message_send)
- Просмотр резюме тратит платный контакт работодателя, ошибка в вызове стоит денег
- OAuth-токены работодателя дают широкий доступ к вакансиям, откликам и резюме кандидатов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Девять инструментов покрывают более 70 действий официального работодательского API HeadHunter (hh.kz и hh.ru используют общее API). hh_auth ведет OAuth-флоу от ссылки авторизации до сохранения токенов в ~/.hh-mcp/tokens.json с правами 600 и автообновления по истечении. hh_employer_vacancies управляет своими вакансиями: список активных, архивных и скрытых, CRUD, архивирование, продление, черновики, статистика и посетители. hh_employer_negotiations читает и двигает отклики по этапам, отправляет сообщения кандидатам, приглашает кандидата на вакансию (invite) и хранит шаблоны сообщений. hh_employer_resumes ищет резюме по платной подписке, получение конкретного резюме требует явного confirm: true, потому что тратит платный контакт, здесь же CRUD сохраненных поисков и заметок команды о кандидате. hh_webhooks подписывает на события вроде нового отклика в реальном времени. Публичные части (справочники, подсказки, оценка зарплаты) работают без OAuth.
Для кого. Для HR-менеджеров и рекрутеров в аккаунте работодателя hh.kz или hh.ru, которым нужно вести вакансии, отклики и сорсинг кандидатов из агента.
Подходит, если
- Нужно вести свои вакансии, отклики и переписку с кандидатами через агента
- Нужен сорсинг: поиск резюме по подписке и приглашение подходящих кандидатов
- Нужны вебхуки на новые отклики или изменения статуса в реальном времени
Не подходит, если
- Вы соискатель, а не работодатель: README прямо говорит, что applicant-side пока только в roadmap
- Нет OAuth-приложения работодателя на dev.hh.kz или dev.hh.ru: без client_id и client_secret employer-инструменты не работают
- Не готовы платить за просмотр резюме: get резюме требует confirm: true, потому что тратит платный контакт
Пример запроса к агенту
Покажи новые отклики по вакансии 12345678 и предложи ответ кандидату с приглашением на интервью в ZoomMCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Переменные окружения
HH_CLIENT_IDобязательная, секрет- OAuth client id с dev.hh.kz или dev.hh.ru, нужен для employer-инструментов.
HH_CLIENT_SECRETобязательная, секрет- OAuth client secret того же приложения.
HH_USER_AGENTобязательная- Строка User-Agent с контактным email, hh.kz и hh.ru требуют ее в заголовке.
Ограничения
Версия 0.1, автор сам называет это employer-side MVP. Applicant-side, вебхуки без публичного HTTPS-приемника и удобная дистрибуция вроде Railway или DXT в roadmap, а не готовы. hh_webhooks требует собственный публичный HTTPS-URL для приема событий, который нужно поднимать отдельно. Открытие конкретного резюме тратит платный контакт работодателя, ошибиться с confirm: true недешево.
Как отключить. Удалите блок hh из mcpServers в конфигурации клиента и файл ~/.hh-mcp/tokens.json с сохраненными токенами.
Частые вопросы
Работает ли сервер для соискателя, а не работодателя?
Нет, это employer-side MVP, инструменты для соискателя в roadmap на версию 0.2+.
Почему получение резюме требует отдельного подтверждения?
Потому что просмотр конкретного резюме тратит платный контакт работодателя, поэтому инструмент требует явный confirm: true.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
hh.ru — все инструментыMCP-сервер API hh.ru для соискателя: поиск вакансий, данные работодателей, свои резюме и отклики с сопроводительным письмом
hh.ru MCP
hh-mcp
MCP-сервер для API hh.ru: поиск вакансий и работодателей, оценка зарплат, справочники, резюме при доступе работодателя
MCP-сервер с 52 инструментами по официальному API hh.ru: поиск вакансий без токена, резюме и отклики работодателя с токеном, статистика зарплат
ati-hh-mcp: MCP-сервер для API hh.ru
ati-hh-mcp
Все 135 операций публичного API hh.ru как наборы инструментов: вакансии, отклики, чаты и резюме, запись только с confirm=true
MCP-сервер на FastMCP с 43 инструментами hh.ru: вход через OAuth официального Android-приложения, без регистрации своего приложения на dev.hh.ru
MCP-сервер поиска работы на hh.ru через браузер: рекомендованные вакансии по резюме, отклики и статусы
Коротко о README
README перечисляет девять инструментов с более чем 70 действиями работодательского API HeadHunter, дает таблицу с уровнем авторизации для каждого, шаги установки и OAuth-флоу с сохранением токенов, конфигурацию для Claude Code, Claude Desktop, Cursor, Continue и Cline, а также HTTP-режим для claude.ai-коннектора. Приведены развернутые примеры вызовов: поиск вакансий, отклики, приглашение кандидата, поиск и просмотр резюме, заметки о кандидате, подписка на вебхуки. В roadmap новый chat API, биллинг, applicant-side и хостинг на Railway. Лицензия MIT.