Коннектор

hh.ru API: ИИ-агент для подбора и адаптации

Сервиса нет в каталоге. Подключение по описанию API.

hh.ru API — программный доступ к вакансиям, резюме и откликам на HeadHunter. Карточка о том, как подключить к нему агента: она для кадровика, который вручную разбирает отклики и листает резюме.

Что такое агент

Агент — программа, которая делает дело целиком, а не отвечает на вопрос: работает в ваших сервисах, доводит до результата и не ждёт, пока его окликнут. Чат-бот вернёт текст, агент вернётся с результатом.

Что такое коннектор

Коннектор — описание подключения: где взять доступ, как проверить связь и какие данные агент увидит. Это не плагин и не доработка: вы регистрируете приложение, а логин и пароль пользователя не передаются.

Что это за сервис

HeadHunter API даёт информацию о соискателях и компаниях и позволяет использовать функциональность hh.ru на своём сайте или в приложении. В описании подчёркнуто: доступ идёт без получения и хранения логина и пароля пользователя. Есть подписка на события и фильтр change_after.

Что делает агент с hh.ru

### Активный сорсинг по открытым базам

Агент переводит требования вакансии в фильтры поиска — регион, опыт, занятость, ключевые навыки — и собирает подходящие резюме пачками, а не по одному, с датой последнего обновления. Каждое сверяет с требованиями и отмечает, чего не хватает. Список приходит со ссылкой на резюме и датой обновления, чтобы не звонить по устаревшей информации и не тратить время на устаревшие резюме.

### Разбор откликов: ранжирование кандидатов

Агент читает отклики и раскладывает кандидатов по группам: подходит, уточнить, не подходит, — и ведёт счёт по каждой группе, чтобы было видно, где воронка провисает. Спорные случаи выносит отдельно с причиной — например, опыт не тот, но навыки совпадают. Итог — очередь на звонок, отсортированная по соответствию, а не по времени отклика, как в обычном списке откликов по времени прихода.

### Публикация вакансии на площадках

Агент собирает текст вакансии из карточки и проверяет его на служебные пометки и дискриминационные формулировки. Он подставляет город, формат работы и вилку и отдаёт готовый вариант на публикацию вместе с коротким описанием для соцсетей и требованиями к опыту. Ошибки в заголовке и грейде ловятся до отправки, а не после первых откликов и звонков от кандидатов, которые уже неактуальны.

Что остаётся человеку

Собеседование, оффер и отказ. Агент ранжирует и готовит текст, а решение о человеке принимает рекрутер.

Как подключить

Нужно приложение, зарегистрированное на hh.ru: доступ к данным идёт по OAuth, без хранения пароля пользователя. Параметры и права выдаются в кабинете разработчика; состав методов и лимиты уточняются при подключении.

Чего агент не делает

Не пишет кандидатам от вашего имени. Не обходит правила площадки и лимиты запросов. Не хранит логины и пароли пользователей.

Вопросы

Что такое агент, если коротко? Программа, которая доводит дело до результата: берёт вакансию, находит резюме, сверяет с требованиями и отдаёт очередь на звонок. От чат-бота отличается тем, что работает без вопроса и по расписанию, а не отвечает в окне по запросу.

Что такое коннектор? Описание подключения: где взять доступ, как проверить связь и какие данные агент увидит. Не плагин и не доработка — зарегистрированное приложение и выданные права. Пароль агент не хранит, работает по токену, который можно отозвать.

Нужен ли отдельный аккаунт работодателя? Доступ идёт через приложение на hh.ru и авторизацию по OAuth: логин и пароль пользователя агент не получает и не хранит. Какие права нужны приложению, зависит от задач: чтение резюме и работа с откликами различаются по объёму.

Подключение

  1. Шаг 1: зарегистрировать приложение на hh.ru и получить параметры доступа — логин и пароль пользователя не используются.
  2. Шаг 2: авторизоваться по OAuth и проверить связь чтением своей вакансии или резюме.
  3. Шаг 3: отдать агенту требования по открытым вакансиям, чтобы он ранжировал отклики по вашим критериям.

Роли

Сценарии