hh.ru MCP
hh-mcp
MCP-сервер для API hh.ru: поиск вакансий и работодателей, оценка зарплат, справочники, резюме при доступе работодателя
Установка
claude mcp add hh -- npx -y @theyahia/hh-mcpС токеном: claude mcp add hh -e HH_ACCESS_TOKEN=your-token -- npx -y @theyahia/hh-mcp
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту 19 инструментов API hh.ru. Без токена доступны поиск вакансий с фильтрами по региону, роли, зарплате, опыту и формату работы, карточки вакансий и похожие вакансии, данные работодателей, справочники регионов, ролей, отраслей и метро, автодополнение. Инструмент статистики зарплат считает медиану и перцентили по опубликованным вакансиям, это оценка, а не рыночные данные. Поиск и просмотр резюме работают только с токеном работодателя и оплаченным доступом к базе. Ответы по умолчанию компактные, полный JSON отдается по флагу raw.
Для кого. Рекрутерам, HR-аналитикам и соискателям, которые работают с вакансиями на hh.ru.
Подходит, если
- Нужно подобрать вакансии по стеку, городу и зарплате
- Нужно прикинуть вилку зарплат по роли в регионе
- Нужно посмотреть все открытые вакансии конкретной компании
Не подходит, если
- Нужен отклик на вакансию или управление своими вакансиями: таких инструментов нет
- Нужны официальные данные рынка труда, а не оценка по объявлениям
Пример запроса к агенту
Найди удаленные вакансии Python-разработчика в Москве от 300 000 рублей и оцени медианную зарплату по этой ролиОграничения
Резюме доступны только с OAuth-токеном работодателя и оплаченной подпиской на базу резюме, иначе API вернет 403. Встроенный лимит 5 запросов в секунду общий на процесс, в HTTP-режиме его делят все клиенты. HTTP-режим не имеет своей авторизации и по умолчанию слушает только localhost.
Как отключить. Удалите сервер командой claude mcp remove hh или уберите блок hh из конфигурации клиента.
MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| HH_ACCESS_TOKEN секрет | OAuth-токен работодателя для доступа к резюме |
| HH_USER_AGENT | Собственный заголовок HH-User-Agent |
| HTTP_PORT | Порт HTTP-режима, по умолчанию 3000 |
Проверка безопасности
- Ходит в API hh.ru
- С токеном работодателя получает резюме с персональными данными кандидатов
Коротко о README
README на русском разделяет режимы без токена и с токеном и честно предупреждает об условиях доступа к резюме. Приведены конфигурации для Claude Desktop, Claude Code, VS Code, Cursor и Windsurf, а также запуск в режиме Streamable HTTP с защитой от DNS rebinding. Все инструменты сведены в таблицы с пометкой, нужен ли токен. В репозитории есть скилл job-search для поиска вакансий с оценкой зарплат. Лицензия MIT.
Частые вопросы
Нужна ли регистрация на hh.ru?
Для вакансий, работодателей, зарплат и справочников нет. Токен с dev.hh.ru нужен только для резюме.
Насколько точна статистика зарплат?
Она считается по вакансиям с указанной зарплатой, выборка смещенная. Используйте ее как ориентир.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения