MCP для hh.ru: серверы для соискателей и рекрутеров

MCP-сервер для hh.ru подключает к вакансиям HeadHunter агентов Claude Code, Cursor и Codex. Поиск вакансий, справочники и оценка зарплат работают по официальному API почти без настроек. Отклики соискателя в публичном API больше не описаны, поэтому для них серверы управляют вашим браузером, а это риск для аккаунта.

HeadHunterCRM, задачи и коммуникацииПроверено

Как подключить hh.ru к агенту

Что значит уровень доступа

Установка одной командой

npx skillfoxx add mcp/headhunter-mcp-server

Пример для карточки «HeadHunter MCP Server». Любой инструмент ставится так же, по адресу из каталога. CLI проверит подпись рецепта и сам пропишет настройки агента.

Российские агенты

Совместимость по документации агента

MCP-серверы

15 карточекВсе 15

MCP-сервер API hh.ru для соискателя: поиск вакансий, данные работодателей, свои резюме и отклики с сопроводительным письмом

Широкий доступ39Звезды репозитория

Монорепозиторий MCP-серверов для российских сервисов и API стран СНГ: платежи, CRM, маркетплейсы, доставка, HR и справочные данные

Широкий доступ38Звезды репозитория

hh.ru MCP

hh-mcp

MCP-сервер для API hh.ru: поиск вакансий и работодателей, оценка зарплат, справочники, резюме при доступе работодателя

Расширенный доступ10Звезды репозитория

MCP-сервер поиска работы на hh.ru через браузер: рекомендованные вакансии по резюме, отклики и статусы

Широкий доступ3Звезды репозитория

MCP-сервер, который собирает вакансии из hh.ru и публичных API Greenhouse, Ashby, Lever, Workable и Bayt в едином формате без парсинга HTML

Расширенный доступ1Звезды репозитория

MCP-сервер для работодательской части API hh.ru и hh.kz: свои вакансии, отклики, поиск резюме, сорсинг и вебхуки через OAuth-приложение

Широкий доступ1Звезды репозитория

Еще инструменты

2 карточки

Автоматизация поиска работы на hh.ru: сбор вакансий, оценка по CV через LLM, сопроводительные письма и отклики

СкиллШирокий доступ199Звезды репозитория

Скрипты на Node.js и Playwright ищут вакансии на hh.ru, оценивают их через LLM, пишут сопроводительные и открывают отклик в браузере

CLIШирокий доступ2Звезды репозитория

Задачи соискателя и рекрутера

Соискателю нужно найти вакансии и подготовить отклик, рекрутеру разобрать отклики и найти кандидатов.

  • Искать вакансии и сравнивать зарплаты. Сервер hh.ru MCP дает 19 инструментов API с фильтрами по региону, роли, опыту и формату работы и считает медиану и перцентили зарплат. Набор на 52 инструмента со скиллом /job-search дает hh-mcp от andreytepaykin.
  • Подготовить сопроводительное письмо. hh-apply-suite разбирает вакансию, отбирает подходящие репозитории кандидата на GitHub, пишет письмо на 150–220 слов и проверяет его по ключевым словам ATS. Отклик пользователь отправляет сам.
  • Получать новые вакансии в Telegram. Монитор вакансий HH.ru раз в 15 минут присылает ссылки на новые вакансии.
  • Собрать вакансии из hh.ru и зарубежных ATS. ats-mcp-server ищет одновременно по hh.ru, Greenhouse, Ashby, Lever, Workable и Bayt.
  • Вести вакансии и отклики работодателя. hh-mcp-ru открывает 133 метода официального API, из них 32 меняют данные, и перед изменением требует подтверждения. Сервер для hh.ru и hh.kz двигает отклики по этапам и приглашает кандидатов.
  • Откликаться из агента. HH MCP Server и hh-cv-mcp работают через вашу браузерную сессию и отправляют отклики с письмом. У hh-cv-mcp около тридцати инструментов, 11 из них меняют данные в аккаунте сразу, без подтверждения.

Что изменилось в API hh.ru для соискателя

Авторы нескольких серверов пишут, что hh.ru закрыл публичный API для соискателей 15 декабря 2025 года. Это сходится с актуальной OpenAPI-спецификацией api.hh.ru: метода, которым соискатель создает отклик, и списка своих резюме в ней нет. Остались поиск вакансий, справочники и методы работодателя.

Поэтому серверы для соискателей идут в обход API. MCP с браузерным авто-откликом эмулирует сессию через Playwright и маскирует автоматизацию, автор прямо пишет о риске бана. Сервер hh-mcp-pro входит от имени официального Android-приложения hh.ru. Это серая зона условий сервиса. Сервер browser-control-mcp только заполняет отклик в открытом Chrome.

Как зарегистрировать приложение и получить токен

Для официального API зарегистрируйте приложение на dev.hh.ru и заберите из кабинета client_id и client_secret. Токен приложения запрашивают методом POST https://api.hh.ru/token. Срок жизни у него неограниченный, а повторный запрос отзывает старый и возможен раз в 5 минут. Для действий от имени пользователя нужна авторизация OAuth: пользователь открывает страницу hh.ru/oauth/authorize и разрешает доступ, логин и пароль приложение не получает.

Без заголовка User-Agent или HH-User-Agent API отвечает ошибкой 400, поэтому hh-mcp-ru требует переменную HH_APP_NAME. Поиск вакансий работает и без токена, но тогда после первого запроса API может попросить капчу. Поиск резюме требует токена работодателя и оплаченного доступа к базе резюме, без него hh.ru вернет 403.

Сервер работодателя hh-mcp-ru ставит команда npx skillfoxx add mcp/hh-mcp-ru, а ключи потом проверяет uvx hh-mcp-ru doctor.

Выбор по уровню доступа

С минимальным доступом работают серверы, которые только читают публичные вакансии. Сервер hh-relay отдает поиск и карточку вакансии через уже одобренное приложение автора. Свой client_id ему не нужен.

Расширенный доступ у серверов на официальном API. С токеном работодателя hh.ru MCP и hh-mcp от andreytepaykin читают резюме. Второй показывает еще воронку откликов и переписку, при этом инструментов отправки в нем нет. Сервер hh-mcp-ru меняет данные в аккаунте только после confirm_write, а необратимые методы просят подтверждения дважды.

Широкий доступ у всех, кто откликается от вашего имени. Сюда же относятся скрипты hh-ru-apply и одноименный CLI: режим hh-fill-letter только вставляет письмо, а hh-apply-chat может отправить отклик сам. Серверы под сценарий найма подберет Foxx AI.

Как не потерять аккаунт hh.ru

Массовые автоотклики, по предупреждениям авторов, могут нарушать правила hh.ru и привести к ограничению аккаунта. Начинайте с поиска и черновиков, отклик отправляйте сами. Cookie hhtoken и файл сессии в ~/.hh-mcp открывают аккаунт целиком.

Работодателю стоит помнить о деньгах. Открытие резюме в сервере для hh.kz и hh.ru тратит платный контакт, поэтому вызов требует confirm: true.

Все карточки сервиса

17 карточек
Показать список

Частые вопросы

Есть ли MCP-сервер у hh.ru для соискателей?

Собственного MCP у hh.ru нет. Все серверы сделаны сообществом. Поиск вакансий идет через официальный API, а отклики соискателя серверы вроде HH MCP Server отправляют через браузерную сессию.

Можно ли откликнуться на вакансию через API hh.ru?

Соискателю через публичный API нельзя. В актуальной спецификации метода отклика нет. Работодатель через API приглашает кандидатов, двигает отклики по этапам и пишет в переписку.

Какая стоимость у API hh.ru?

Стоимость доступа к API в документации hh.ru не указана, приложение регистрируется на dev.hh.ru. Платным бывает доступ к базе резюме: поиск и просмотр резюме требуют оплаченной подписки работодателя.

Как зарегистрировать свой MCP-сервер для hh.ru?

Зарегистрируйте приложение на dev.hh.ru, возьмите client_id, client_secret и токен приложения и передайте их серверу через переменные окружения. Без своего приложения обходится hh-relay, он ходит в API через приложение автора.

Как подключить hh.ru к Claude?

Поставьте сервер командой npx skillfoxx add mcp/hh-mcp. Для поиска вакансий токен не нужен. CLI пропишет его в настройки Claude Code, а Cursor и Codex подключают его тем же способом.

Еще в группе «CRM, задачи и коммуникации»

Весь российский стек