hh-relay: публичный релей поиска hh.ru
hh-relay
Read-only relay поверх api.hh.ru: сам получает OAuth-токен приложения, отдает поиск и карточку вакансии через MCP и ChatGPT Actions без ключей
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Публичный сервер автора ищет вакансии hh.ru через официальный API
- Запросы агента уходят на hh-relay.vercel.app, доступа к аккаунту соискателя нет
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/hh-relayОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Публичный сервер автора ищет вакансии hh.ru через официальный API
- Запросы агента уходят на hh-relay.vercel.app, доступа к аккаунту соискателя нет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
hh.ru требует у клиентов OAuth 2.0 Client Credentials для доступа к своему официальному API, поэтому relay сам хранит client_id и client_secret одобренного приложения hh.ru на сервере и получает application token, а публичные клиенты relay авторизацию не проходят вовсе. REST-эндпоинты GET /api/vacancies/search (до 50 уникальных вакансий за последние 24 часа, с фильтром по региону и опыту) и GET /api/vacancies/{id} отдают нормализованные данные, а поле description с недоверенным HTML от hh.ru явно помечено как требующее безопасной обработки на стороне клиента. Отдельный stateless MCP-эндпоинт /mcp дает два read-only инструмента: search_vacancies и get_vacancy. Ошибки от hh.ru (403, 429, смена схемы ответа) превращаются в стабильные коды вроде upstream_forbidden или upstream_structure_changed, а в логи попадает только путь запроса и тип исключения, без токенов и поискового текста. В комплекте два готовых скилла: поиск python-вакансий и подготовка сопроводительного письма по карточке вакансии через тот же MCP.
Для кого. Для разработчиков ChatGPT Actions и MCP-клиентов, которым нужен публичный поиск вакансий hh.ru без собственной регистрации приложения и OAuth-обвязки.
Подходит, если
- Нужен поиск и карточка вакансии hh.ru без регистрации собственного приложения и получения OAuth-ключей
- Нужен стабильный формат ошибок вместо разбора кодов и структуры ответа api.hh.ru напрямую
- Нужны готовые скиллы поиска python-вакансий и черновика сопроводительного письма
Не подходит, если
- Нужны личные данные аккаунта: отклики, резюме, переписка. Relay работает только с публичным поиском вакансий по application token
- Нужно больше 50 вакансий за один поиск или глубже последних 24 часов: relay сознательно ограничивает выдачу
- Нужен собственный физически изолированный сервер, а не общий публичный https://hh-relay.vercel.app
Пример запроса к агенту
Найди вакансии Python FastAPI в Москве с опытом 1-3 года за последние суткиMCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
HH_CLIENT_IDобязательная, секрет- Client ID одобренного приложения hh.ru, нужен только для собственного экземпляра relay.
HH_CLIENT_SECRETобязательная, секрет- Client Secret того же приложения hh.ru.
Ограничения
Лицензия в репозитории не указана. Нужно одобренное приложение hh.ru с client_id и client_secret, чтобы поднять собственный экземпляр, README прямо предупреждает не передавать их в публичные endpoint'ы и не класть в Git. Поиск ограничен последними 24 часами и 50 уникальными вакансиями за раз. Поле creation_time всегда пустое, потому что официальный API не отдает отдельное подтвержденное значение.
Как отключить. Уберите блок hh-relay из конфигурации MCP клиента или из настроек Custom GPT Action.
Частые вопросы
Нужен ли пользователю ключ hh.ru, чтобы искать вакансии?
Нет, публичные клиенты relay не проходят авторизацию вовсе, ключи хранит только сам relay.
Может ли relay откликнуться на вакансию или показать мои личные данные?
Нет, у него только два read-only инструмента поиска и карточки вакансии по application token, доступа к личному кабинету нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
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
MCP-сервер на FastMCP с 43 инструментами hh.ru: вход через OAuth официального Android-приложения, без регистрации своего приложения на dev.hh.ru
hh.ru MCP
hh-mcp
MCP-сервер для API hh.ru: поиск вакансий и работодателей, оценка зарплат, справочники, резюме при доступе работодателя
MCP-сервер поиска работы на hh.ru через браузер: рекомендованные вакансии по резюме, отклики и статусы
Коротко о README
README описывает FastAPI relay для Custom GPT Action и MCP, который сам получает application token по OAuth 2.0 Client Credentials и отдает поиск вакансий hh.ru. Перечислены REST-эндпоинты с примерами curl, полный список кодов ошибок upstream, раздел про MCP для ChatGPT с публичным адресом без авторизации и шаги деплоя на Vercel с переменными окружения. Тесты используют обезличенные fixtures и не обращаются к hh.ru.