HH MCP Server
MCP-сервер поиска работы на hh.ru через браузер: рекомендованные вакансии по резюме, отклики и статусы
- 3 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Может отправлять отклики на вакансии от вашего имени с сопроводительным письмом
- Использует браузерную автоматизацию на реальном аккаунте hh.ru, что может противоречить правилам сервиса
Установка
- Работает в
- Сервисы
Ручная установка
cd hh-mcp-server
uv sync
uv run playwright install chromium
uv run hh-mcp-server --loginПоследняя команда открывает браузер для входа в аккаунт hh.ru, сессия сохраняется в ~/.hh-mcp/profile/state.json.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Может отправлять отклики на вакансии от вашего имени с сопроводительным письмом
- Использует браузерную автоматизацию на реальном аккаунте hh.ru, что может противоречить правилам сервиса
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер управляет вашим собственным аккаунтом hh.ru через Playwright и дает агенту девять инструментов: поиск вакансий по ключевым словам, городу, зарплате, опыту и графику, получение вакансий, подобранных алгоритмом hh.ru под конкретное резюме (до 1000 вакансий за счет постраничного обхода), детали вакансии, список и полное содержимое своих резюме, отклик на вакансию с сопроводительным письмом и ответами на обязательные вопросы работодателя в двухшаговом сценарии, отслеживание статусов отправленных откликов, карточку работодателя и закрытие сессии. Авторизация проходит один раз через открытие браузера, дальше сессия сохраняется в файле на диске.
Для кого. Для соискателей, которые хотят искать и подавать заявки на hh.ru прямо из Claude Code без переключения в браузер.
Подходит, если
- Нужен точный подбор вакансий под конкретное резюме через алгоритм hh.ru, а не только по ключевым словам
- Нужно отвечать на обязательные вопросы работодателя при отклике прямо из агента
- Нужно отслеживать статусы уже отправленных откликов без захода на сайт
Не подходит, если
- Не хотите проходить авторизацию через открытие браузера на своем аккаунте hh.ru
- Нужен официальный API hh.ru, а не браузерная автоматизация
- Не готовы разрешать агенту откликаться от вашего имени даже с двухшаговым подтверждением
Пример запроса к агенту
Покажи рекомендованные вакансии по моему резюме и подай заявку на первую с ответом на вопрос о зарплатных ожиданияхMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Нужны Python 3.12+ и менеджер пакетов uv. Работа идет через браузерную автоматизацию Playwright, а не официальный API hh.ru, поведение сайта может измениться и сломать селекторы. Сессия хранится в файле ~/.hh-mcp/profile/state.json на диске.
Как отключить. Удалите блок hh из .claude/settings.json и файл сессии ~/.hh-mcp/profile/state.json.
Частые вопросы
Как сервер отвечает на обязательные вопросы работодателя?
Первый вызов apply_to_vacancy без question_answers возвращает список вопросов, второй вызов с ответами отправляет отклик.
Чем get_recommended_vacancies лучше поиска по ключевым словам?
Использует тот же алгоритм hh.ru, что и страница «Подходящие вакансии», учитывая опыт, навыки и должность из резюме, а не только текст запроса.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
hh.ru — все инструментыHH.ru MCP Server: браузерный авто-отклик
HH.ru MCP Server
MCP-сервер, который эмулирует браузерную сессию hh.ru через Playwright для поиска, ИИ-скоринга вакансий и автоматического отклика с ограничением заявок в день
hh.ru MCP
hh-mcp
MCP-сервер для API hh.ru: поиск вакансий и работодателей, оценка зарплат, справочники, резюме при доступе работодателя
MCP-сервер с 52 инструментами по официальному API hh.ru: поиск вакансий без токена, резюме и отклики работодателя с токеном, статистика зарплат
MCP-сервер API hh.ru для соискателя: поиск вакансий, данные работодателей, свои резюме и отклики с сопроводительным письмом
ats-mcp-server: вакансии из hh.ru и систем найма
ats-mcp-server
MCP-сервер, который собирает вакансии из hh.ru и публичных API Greenhouse, Ashby, Lever, Workable и Bayt в едином формате без парсинга HTML
MCP-сервер для работодательской части API hh.ru и hh.kz: свои вакансии, отклики, поиск резюме, сорсинг и вебхуки через OAuth-приложение
Коротко о README
README на русском описывает девять MCP-инструментов с примерами вызова, включая двухшаговый отклик с вопросами работодателя и постраничный сбор рекомендованных вакансий до 1000 штук. Показаны установка через uv sync, вход в аккаунт командой --login с сохранением сессии в файл, три режима запуска (stdio, видимый браузер для отладки, HTTP) и структура проекта по слоям drivers, scraping, tools.