HH MCP Server
MCP-сервер поиска работы на hh.ru через браузер: рекомендованные вакансии по резюме, отклики и статусы
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может отправлять отклики на вакансии от вашего имени с сопроводительным письмом
- Использует браузерную автоматизацию на реальном аккаунте 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 через Playwright и дает агенту девять инструментов: поиск вакансий по ключевым словам, городу, зарплате, опыту и графику, получение вакансий, подобранных алгоритмом hh.ru под конкретное резюме (до 1000 вакансий за счет постраничного обхода), детали вакансии, список и полное содержимое своих резюме, отклик на вакансию с сопроводительным письмом и ответами на обязательные вопросы работодателя в двухшаговом сценарии, отслеживание статусов отправленных откликов, карточку работодателя и закрытие сессии. Авторизация проходит один раз через открытие браузера, дальше сессия сохраняется в файле на диске.
Для кого. Для соискателей, которые хотят искать и подавать заявки на hh.ru прямо из Claude Code без переключения в браузер.
Подходит, если
- Нужен точный подбор вакансий под конкретное резюме через алгоритм hh.ru, а не только по ключевым словам
- Нужно отвечать на обязательные вопросы работодателя при отклике прямо из агента
- Нужно отслеживать статусы уже отправленных откликов без захода на сайт
Не подходит, если
- Не хотите проходить авторизацию через открытие браузера на своем аккаунте hh.ru
- Нужен официальный API hh.ru, а не браузерная автоматизация
- Не готовы разрешать агенту откликаться от вашего имени даже с двухшаговым подтверждением
Пример запроса к агенту
Покажи рекомендованные вакансии по моему резюме и подай заявку на первую с ответом на вопрос о зарплатных ожиданияхОграничения
Нужны Python 3.12+ и менеджер пакетов uv. Работа идет через браузерную автоматизацию Playwright, а не официальный API hh.ru, поведение сайта может измениться и сломать селекторы. Сессия хранится в файле ~/.hh-mcp/profile/state.json на диске.
Как отключить. Удалите блок hh из .claude/settings.json и файл сессии ~/.hh-mcp/profile/state.json.
MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Проверка безопасности
- Может отправлять отклики на вакансии от вашего имени с сопроводительным письмом
- Использует браузерную автоматизацию на реальном аккаунте hh.ru, что может противоречить правилам сервиса
Коротко о README
README на русском описывает девять MCP-инструментов с примерами вызова, включая двухшаговый отклик с вопросами работодателя и постраничный сбор рекомендованных вакансий до 1000 штук. Показаны установка через uv sync, вход в аккаунт командой --login с сохранением сессии в файл, три режима запуска (stdio, видимый браузер для отладки, HTTP) и структура проекта по слоям drivers, scraping, tools.
Частые вопросы
Как сервер отвечает на обязательные вопросы работодателя?
Первый вызов apply_to_vacancy без question_answers возвращает список вопросов, второй вызов с ответами отправляет отклик.
Чем get_recommended_vacancies лучше поиска по ключевым словам?
Использует тот же алгоритм hh.ru, что и страница «Подходящие вакансии», учитывая опыт, навыки и должность из резюме, а не только текст запроса.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI