hh.ru MCP
hh-mcp
MCP-сервер для API hh.ru: поиск вакансий и работодателей, оценка зарплат, справочники, резюме при доступе работодателя
- 5 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ходит в API hh.ru
- С токеном работодателя получает резюме с персональными данными кандидатов
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/hh-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ходит в API hh.ru
- С токеном работодателя получает резюме с персональными данными кандидатов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту 19 инструментов API hh.ru. Без токена доступны поиск вакансий с фильтрами по региону, роли, зарплате, опыту и формату работы, карточки вакансий и похожие вакансии, данные работодателей, справочники регионов, ролей, отраслей и метро, автодополнение. Инструмент статистики зарплат считает медиану и перцентили по опубликованным вакансиям, это оценка, а не рыночные данные. Поиск и просмотр резюме работают только с токеном работодателя и оплаченным доступом к базе. Ответы по умолчанию компактные, полный JSON отдается по флагу raw.
Для кого. Рекрутерам, HR-аналитикам и соискателям, которые работают с вакансиями на hh.ru.
Подходит, если
- Нужно подобрать вакансии по стеку, городу и зарплате
- Нужно прикинуть вилку зарплат по роли в регионе
- Нужно посмотреть все открытые вакансии конкретной компании
Не подходит, если
- Нужен отклик на вакансию или управление своими вакансиями: таких инструментов нет
- Нужны официальные данные рынка труда, а не оценка по объявлениям
Пример запроса к агенту
Найди удаленные вакансии Python-разработчика в Москве от 300 000 рублей и оцени медианную зарплату по этой ролиMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
HH_ACCESS_TOKENсекрет- OAuth-токен работодателя для доступа к резюме
HH_USER_AGENT- Собственный заголовок HH-User-Agent
HTTP_PORT- Порт HTTP-режима, по умолчанию 3000
Ограничения
Резюме доступны только с OAuth-токеном работодателя и оплаченной подпиской на базу резюме, иначе API вернет 403. Встроенный лимит 5 запросов в секунду общий на процесс, в HTTP-режиме его делят все клиенты. HTTP-режим не имеет своей авторизации и по умолчанию слушает только localhost.
Как отключить. Удалите сервер командой claude mcp remove hh или уберите блок hh из конфигурации клиента.
Частые вопросы
Нужна ли регистрация на hh.ru?
Для вакансий, работодателей, зарплат и справочников нет. Токен с dev.hh.ru нужен только для резюме.
Насколько точна статистика зарплат?
Она считается по вакансиям с указанной зарплатой, выборка смещенная. Используйте ее как ориентир.
Чем hh.ru MCP отличается от поиска вакансий на сайте?
Сервер дает агенту 19 инструментов API hh.ru. Без токена доступны поиск вакансий с фильтрами по региону, роли, зарплате, опыту и формату работы, карточки и похожие вакансии, данные работодателей, справочники. Резюме доступны при доступе работодателя.
Нужна ли регистрация на hh.ru и насколько точна статистика зарплат?
Для публичного поиска токен не нужен. Установка: claude mcp add hh -- npx -y @theyahia/hh-mcp. Оценка зарплат строится по данным вакансий и дает ориентир, а не точное значение. Работает в Claude Desktop, Claude Code, VS Code, Cursor и Windsurf.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
hh.ru — все инструментыMCP-сервер с 52 инструментами по официальному API hh.ru: поиск вакансий без токена, резюме и отклики работодателя с токеном, статистика зарплат
MCP-сервер для работодательской части API hh.ru и hh.kz: свои вакансии, отклики, поиск резюме, сорсинг и вебхуки через OAuth-приложение
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
Коротко о README
README на русском разделяет режимы без токена и с токеном и честно предупреждает об условиях доступа к резюме. Приведены конфигурации для Claude Desktop, Claude Code, VS Code, Cursor и Windsurf, а также запуск в режиме Streamable HTTP с защитой от DNS rebinding. Все инструменты сведены в таблицы с пометкой, нужен ли токен. В репозитории есть скилл job-search для поиска вакансий с оценкой зарплат. Лицензия MIT.