Что такое hh.ru
hh.ru — крупнейшая в России платформа для поиска работы и сотрудников: миллионы вакансий и резюме, база работодателей, справочники регионов и профессиональных ролей. Для рекрутёров и HR это основной источник данных о рынке труда и кандидатах.
Интеграция подключает hh.ru к ИИ-агенту СуперИнтеллекта через официальный API. Доступ к публичным данным (вакансии, работодатели, справочники) открывается по app-токену, а к базе резюме и откликам — по пользовательскому OAuth-токену.
Зачем подключать к СуперИнтеллекту
Вместо ручного перебора вкладок и фильтров вы ставите задачу агенту обычными словами — «найди вакансии Java-разработчика в Питере от 200 тысяч» — и получаете готовый результат. Агент сам обращается к hh.ru, собирает данные и оформляет ответ.
- Экономит часы рекрутёра на поиске и сортировке вакансий и резюме.
- Сводит зарплатные вилки и требования рынка в готовую выжимку.
- Держит под контролем работодателей-конкурентов и поток откликов.
- Понимает запросы на обычном языке — не нужно знать коды регионов и проф.ролей.
Как применять внутри платформы
- Поиск вакансий по тексту, региону, зарплате, опыту, типу занятости, графику и проф.роли.
- Карточки вакансий и подбор похожих позиций.
- Поиск работодателей, их карточки и список активных вакансий.
- Мониторинг рынка труда и зарплат по нужным ролям и городам.
- Поиск и просмотр резюме кандидатов — на пользовательском токене и платном доступе к API резюме hh.ru.
- Контроль откликов и приглашений (negotiations) — на пользовательском токене.
- Справочники регионов, проф.ролей и автоподсказки должностей и регионов.
Коннектор не публикует вакансии и не отвечает кандидатам автоматически — он про поиск, аналитику и мониторинг, а на платном доступе — про подбор по базе резюме.
Кому полезно
Рекрутёрам, HR-менеджерам, руководителям подбора и владельцам бизнеса, которые сами закрывают вакансии. Особенно — тем, кто регулярно анализирует рынок труда, следит за конкурентами и ведёт активный сорсинг. ИИ-агент ускоряет рутину, а финальное решение о найме остаётся за человеком.
В связке с другими HR-интеграциями платформы — SuperJob и Хантфлоу — агент закрывает весь цикл: от поиска кандидатов до ведения воронки. Обзор возможностей — в разделе «ИИ для HR».
Как подключить hh.ru / HeadHunter
Аккаунт на dev.hh.ru и OAuth2 access-токен hh.ru (для резюме и откликов — пользовательский токен + платный доступ к API резюме).
- 1
Получите access-токен
Зайдите в кабинет разработчика hh.ru на dev.hh.ru/admin и получите OAuth2 access-токен. App-токен (client_credentials) открывает публичные чтения — вакансии, работодателей, справочники. Для базы резюме и откликов нужен пользовательский OAuth-токен.
- 2
Откройте интеграции ассистента
В СуперИнтеллекте перейдите в настройки нужного ассистента → раздел «Интеграции» → выберите hh.ru.
- 3
Вставьте токен
Вставьте access-токен в поле интеграции hh.ru. Опционально добавьте client_id, client_secret и refresh-токен — тогда токен будет обновляться автоматически. Можно указать свой User-Agent.
- 4
Сохраните и проверьте
Сохраните настройки и напишите агенту первый запрос, например: «Найди вакансии аналитика в Москве от 150 000 ₽». Если агент вернул список — всё работает.
| Что нужно | Где взять |
|---|---|
| OAuth2 access-токен | Кабинет разработчика hh.ru — dev.hh.ru/admin (app-токен для публичных чтений; пользовательский OAuth-токен для резюме и откликов) |
| client_id + client_secret (опционально) | Карточка приложения на dev.hh.ru/admin — для авто-обновления токена |
| refresh-токен (опционально) | Выдаётся при пользовательской OAuth-авторизации на hh.ru — включает авто-рефреш |
| User-Agent (опционально) | Указывается вручную в настройках интеграции по требованию hh.ru API |
Access-токен живёт около 14 дней; с client_id, client_secret и refresh-токеном он обновляется автоматически. Поиск и просмотр резюме требуют пользовательского OAuth-токена и платного доступа к API резюме hh.ru — app-токен даёт только публичные чтения. Отклики (negotiations) доступны на пользовательском токене.
Подключите hh.ru / HeadHunter к вашему ИИ-агенту
Создайте ассистента на платформе СуперИнтеллект, добавьте hh.ru / HeadHunter в настройках интеграций и управляйте сервисом обычными фразами в чате. На тарифе Free — 0 ₽ и 75 нейронов на старте.
