hh-mcp: 52 инструмента для hh.ru
hh-mcp
MCP-сервер с 52 инструментами по официальному API hh.ru: поиск вакансий без токена, резюме и отклики работодателя с токеном, статистика зарплат
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- С токеном работодателя возвращает резюме кандидатов и переписку по откликам
- Инструментов отправки откликов или сообщений нет, только чтение, но токен стоит хранить как секрет
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/andreytepaykin-hh-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- С токеном работодателя возвращает резюме кандидатов и переписку по откликам
- Инструментов отправки откликов или сообщений нет, только чтение, но токен стоит хранить как секрет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает официальный API hh.ru (dev.hh.ru) в 52 инструмента. Без токена доступны поиск вакансий по ключевым словам, региону, роли, зарплате и опыту, карточка вакансии, похожие и связанные вакансии, профили и вакансии работодателей, статистика зарплат по объявлениям, а также все справочники: регионы, отрасли, метро, языки, навыки. С токеном работодателя (HH_ACCESS_TOKEN) добавляются поиск резюме, карточки откликов, воронка ATS по этапам, переписка с кандидатами и статистика по менеджерам, но поиск резюме и ATC дополнительно требуют оплаченную подписку на базу резюме, иначе hh.ru отвечает 403. Ответы по умолчанию приходят компактными сводками для LLM, параметр raw: true возвращает полный JSON hh.ru. Встроенный лимитер соблюдает 5 запросов в секунду от hh.ru и повторяет запрос при 429 и 5xx с экспоненциальной задержкой. Есть отдельный HTTP-режим со stateless-эндпоинтом и защитой от DNS-rebinding, и приложенный скилл Claude Code /job-search с готовым алгоритмом поиска и разбора откликов.
Для кого. Для соискателей, которые ищут вакансии и сравнивают зарплаты через агента, и для рекрутеров с платным доступом к hh.ru, которым нужна воронка откликов в чате.
Подходит, если
- Нужно искать вакансии на hh.ru по зарплате, региону и опыту прямо из агента, без токена
- Нужна оценка медианной зарплаты по роли и региону
- Есть employer-токен hh.ru с платной базой резюме и нужно разбирать отклики и переписку с кандидатами
Не подходит, если
- Нужен поиск резюме или разбор откликов, но нет employer-токена с оплаченной подпиской на базу резюме: hh.ru вернет 403
- Нужно, чтобы агент сам откликался на вакансии или отправлял сообщения кандидатам: инструментов для этого нет, только чтение
- Нужна статистика зарплат из официального платного Банка данных без токена и area_id: без них используется оценка по объявлениям
Пример запроса к агенту
Найди удаленные вакансии Python-разработчика в Москве от 300 000 рублей и покажи медианную зарплатуMCP
- Транспорт
- stdio, http
- Авторизация
- ключ необязателен
Переменные окружения
HH_ACCESS_TOKENсекрет- OAuth 2.0 Bearer-токен hh.ru, нужен для резюме, ATS и employer-scoped эндпоинтов, выдается на dev.hh.ru/admin.
HH_USER_AGENT- Свой HH-User-Agent, который требует hh.ru, рекомендуемый формат your-app/1.0 (you@example.com).
HH_MAX_SCAN_PAGES- Лимит страниц hh.ru при сканировании откликов с фильтром, по умолчанию 10.
Ограничения
Основано на проекте @theyahia/hh-mcp, это форк с переработкой, а не оригинальная идея. Поиск резюме и ATS требуют кроме employer-токена оплаченную подписку на базу резюме. Соискательские и анонимные токены получают 403. Встроенный лимитер общий на процесс, поэтому в HTTP-режиме с несколькими клиентами они делят один бюджет 5 запросов в секунду. HTTP-режим по умолчанию слушает только localhost, для внешнего доступа нужно самому настраивать HH_ALLOWED_HOSTS, HH_ALLOWED_ORIGINS и аутентификацию.
Как отключить. Выполните claude mcp remove hh в Claude Code или удалите блок hh из mcpServers в конфигурации клиента.
Частые вопросы
Обязателен ли токен для поиска вакансий?
Нет, поиск вакансий, карточки, справочники и оценка зарплат по объявлениям работают без токена.
Хватит ли обычного employer-токена для поиска резюме?
Нет, дополнительно нужна оплаченная подписка на базу резюме, иначе hh.ru отвечает 403 даже с валидным токеном.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
hh.ru — все инструментыhh.ru MCP
hh-mcp
MCP-сервер для API hh.ru: поиск вакансий и работодателей, оценка зарплат, справочники, резюме при доступе работодателя
ati-hh-mcp: MCP-сервер для API hh.ru
ati-hh-mcp
Все 135 операций публичного API hh.ru как наборы инструментов: вакансии, отклики, чаты и резюме, запись только с confirm=true
MCP-сервер поиска работы на hh.ru через браузер: рекомендованные вакансии по резюме, отклики и статусы
MCP-сервер для работодательской части API hh.ru и hh.kz: свои вакансии, отклики, поиск резюме, сорсинг и вебхуки через OAuth-приложение
HH.ru MCP Server: браузерный авто-отклик
HH.ru MCP Server
MCP-сервер, который эмулирует браузерную сессию hh.ru через Playwright для поиска, ИИ-скоринга вакансий и автоматического отклика с ограничением заявок в день
ats-mcp-server: вакансии из hh.ru и систем найма
ats-mcp-server
MCP-сервер, который собирает вакансии из hh.ru и публичных API Greenhouse, Ashby, Lever, Workable и Bayt в едином формате без парсинга HTML
Коротко о README
README перечисляет 52 инструмента по разделам (вакансии, резюме, ATS/отклики, работодатели, справочники, зарплаты), таблицу режимов без токена и с токеном, инструкции установки для Claude Desktop, Claude Code, VS Code/Cursor, Windsurf и отдельного HTTP-режима, переменные окружения и демо-промпты. Указано, что проект основан на @theyahia/hh-mcp. Лицензия MIT.