hh-mcp-pro: hh.ru через OAuth Android-приложения
hh-mcp-pro
MCP-сервер на FastMCP с 43 инструментами hh.ru: вход через OAuth официального Android-приложения, без регистрации своего приложения на dev.hh.ru
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- apply_to_vacancy, apply_two_step и send_message пишут в живой аккаунт и переписку с работодателем напрямую
- Вход через OAuth официального мобильного приложения hh.ru вместо собственного приложения может нарушать условия сервиса
- Токен дает широкий доступ к резюме, откликам и переписке соискателя
Установка
- Работает в
- Сервисы
Ручная установка
uv sync && hh-mcp-pro --loginУстановка зависимостей и одноразовый вход через браузер, команды из README.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- apply_to_vacancy, apply_two_step и send_message пишут в живой аккаунт и переписку с работодателем напрямую
- Вход через OAuth официального мобильного приложения hh.ru вместо собственного приложения может нарушать условия сервиса
- Токен дает широкий доступ к резюме, откликам и переписке соискателя
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Вместо обычной регистрации OAuth-приложения на dev.hh.ru сервер использует так называемый hhandroid-OAuth: авторизацию от лица официального мобильного приложения hh.ru, что снимает необходимость заводить свое приложение и ждать его одобрения. Команда hh-mcp-pro --login открывает браузер для входа и сохраняет токен, дальше становятся доступны 43 инструмента: поиск вакансий и работодателей, статистика зарплат, свои резюме, отклик на вакансию в один или два шага (apply_to_vacancy, apply_two_step), список и чтение переговоров, отправка сообщения в переписке (send_message), справочники регионов, ролей и отраслей, а также аналитика: TF-IDF скоринг вакансии против резюме, разрыв в навыках, статистика по зарплатным вилкам и скелет сопроводительного письма. Архитектура разделена на слои composition/application/domain/infra с OpenTelemetry-трейсингом, health-эндпоинтами readiness и liveness и обязательной bearer-авторизацией для защищенных инструментов.
Для кого. Для разработчиков, которые хотят полный набор действий соискателя на hh.ru без регистрации собственного OAuth-приложения и готовы к правовой неопределенности такого способа входа.
Подходит, если
- Нужен полный набор действий соискателя: поиск, отклик в один или два шага, переписка, резюме, без ожидания одобрения приложения на dev.hh.ru
- Нужна встроенная аналитика: скоринг вакансии, разрыв в навыках, скелет сопроводительного письма
- Устраивает архитектура на FastMCP v3 с трейсингом и health-проверками для продакшен-развертывания
Не подходит, если
- Не хотите входить через OAuth-механизм официального Android-приложения hh.ru вместо своего зарегистрированного приложения: это может нарушать условия hh.ru
- Не готовы, что инструменты apply_to_vacancy и send_message выполняются напрямую без встроенного подтверждения
- Нужна стабильная версия: README одновременно указывает 35 и 43 инструмента, а часть документации помечена как «deferred»
Пример запроса к агенту
Найди вакансии Python-разработчика, оцени топ-3 по совпадению с моим резюме и подготовь скелет сопроводительного письмаMCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Переменные окружения
HH_ACCESS_TOKENсекрет- Готовый токен доступа, если не хотите входить через browser-flow, имеет высший приоритет.
HH_JWT_PUBLIC_KEY- Публичный ключ для проверки bearer-токена в HTTP-режиме сервера.
Ограничения
Лицензия в репозитории не зарегистрирована на GitHub, хотя pyproject.toml и README указывают MIT. hhandroid-OAuth означает вход от лица официального мобильного приложения hh.ru, а не собственного зарегистрированного OAuth-клиента, что находится в серой зоне условий использования API hh.ru. Название репозитория и заголовок README расходятся в числе инструментов: 35 в описании репозитория и plugin.json против 43 в основном тексте README. Значительная часть документации в docs/notes помечена как «deferred» (отложено), то есть не реализована до конца.
Как отключить. Удалите блок hh-mcp-pro из конфигурации MCP клиента и файлы token.json и state.json с сохраненной сессией.
Частые вопросы
Нужно ли регистрировать приложение на dev.hh.ru?
Нет, сервер входит через hhandroid-OAuth, механизм официального мобильного приложения hh.ru, что и заменяет обычную регистрацию.
Может ли сервер отправить отклик или сообщение сам?
Да, инструменты apply_to_vacancy, apply_two_step и send_message выполняют это напрямую без встроенного шага подтверждения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
hh.ru — все инструментыMCP-сервер для работодательской части API hh.ru и hh.kz: свои вакансии, отклики, поиск резюме, сорсинг и вебхуки через OAuth-приложение
MCP-сервер с 52 инструментами по официальному API hh.ru: поиск вакансий без токена, резюме и отклики работодателя с токеном, статистика зарплат
ati-hh-mcp: MCP-сервер для API hh.ru
ati-hh-mcp
Все 135 операций публичного API hh.ru как наборы инструментов: вакансии, отклики, чаты и резюме, запись только с confirm=true
hh.ru MCP
hh-mcp
MCP-сервер для API hh.ru: поиск вакансий и работодателей, оценка зарплат, справочники, резюме при доступе работодателя
HH.ru MCP Server: браузерный авто-отклик
HH.ru MCP Server
MCP-сервер, который эмулирует браузерную сессию hh.ru через Playwright для поиска, ИИ-скоринга вакансий и автоматического отклика с ограничением заявок в день
Read-only relay поверх api.hh.ru: сам получает OAuth-токен приложения, отдает поиск и карточку вакансии через MCP и ChatGPT Actions без ключей
Коротко о README
README описывает MCP-сервер на FastMCP 3.4.7 с 43 инструментами по пяти пространствам имен: auth, vacancies, resumes, applications, dictionaries, плюс аналитика и диагностика. Дана таблица всех инструментов с примерами вызовов, порядок входа через hhandroid-OAuth с приоритетом источника токена, архитектурные слои composition/application/domain/infra с OpenTelemetry и health-эндпоинтами. Отдельно описаны улучшения FastMCP v3+: lifespan management, middleware, пул httpx-клиента. Лицензия MIT.