HH Search -- поиск вакансий на HeadHunter

Описание

Процессор HH Search выполняет поиск вакансий на платформе HeadHunter (hh.ru) через официальный HH API. Процессор работает в двух режимах: как первый процессор в цепочке (поиск вакансий по URL) и как промежуточный (получение детальной информации о вакансиях по ID).

В режиме первого процессора он автоматически обрабатывает пагинацию, разбивает поиск по дням и часам для обхода лимита в 2000 результатов API, дедуплицирует вакансии и обогащает данные информацией о работодателях.

Сценарии использования

• Мониторинг вакансий конкурентов для анализа их кадровой активности
• Поиск компаний, нанимающих специалистов определенного профиля, как сигнал роста бизнеса
• Сбор контактов работодателей, публикующих вакансии в целевых отраслях
• Анализ зарплатных предложений на рынке по выбранным направлениям
• Формирование базы компаний для B2B-продаж на основе их потребности в кадрах
• Получение детальных описаний вакансий для последующей ИИ-фильтрации

Конфигурация

Режим “первый процессор” (поиск вакансий)

Параметр	Тип	Обязательный	По умолчанию	Описание
searchUrl	string	Да	—	URL поиска вакансий с hh.ru. Скопируйте URL из адресной строки после настройки фильтров на сайте
startDate	string (datetime)	Нет	—	Дата начала периода поиска. Если не указана, используется дата последнего успешного запуска
searchOnlyNew	boolean	Нет	false	Искать только новые вакансии с последнего запуска. При повторных запусках автоматически сдвигает дату начала
processingMode	"vacancy" / "employer"	Нет	"vacancy"	Режим дедупликации: vacancy — не дублировать переопубликованные вакансии, employer — не дублировать работодателей
additionalFields	string[]	Нет	—	Дополнительные поля для включения в выходной пакет: keySkills, fullDescription, timezoneUtc, initial_created_at, employerAccreditedIt

Режим “не первый процессор” (детали вакансии)

Параметр	Тип	Обязательный	По умолчанию	Описание
vacancyId	string	Нет	—	ID вакансии для получения деталей. Поддерживает переменные: {{hhSearch.id}}
maxPackets	number	Нет	50	Максимальное количество входных пакетов для обработки за один запуск
selectedFields	string[]	Нет	—	Выбранные поля для включения в выходной пакет

Входные данные

Режим “первый процессор”

Входные данные не требуются. Процессор самостоятельно выполняет поиск по заданному searchUrl.

Режим “не первый процессор”

Принимает DataPackets от родительских процессоров, содержащие ID вакансий или другие данные для поиска деталей. Переменные из chainData используются для подстановки в vacancyId.

Выходные данные

Каждая найденная вакансия создает отдельный DataPacket со следующей структурой:

{
  "id": "12345678",
  "name": "Менеджер по продажам",
  "url": "https://api.hh.ru/vacancies/12345678",
  "publishedAt": "2026-03-01T10:30:00+0300",
  "address": "г. Москва, ул. Тверская, д. 12",
  "salaryFrom": 80000,
  "salaryCurrency": "RUR",
  "shortRequirement": "Опыт продаж от 2 лет...",
  "shortResponsibility": "Привлечение новых клиентов...",
  "employerId": "54321",
  "employerName": "ООО Рога и Копыта",
  "employerSiteUrl": "https://example.com",
  "employerType": "company",
  "employerDescription": "Крупная производственная компания...",
  "employerOpenVacancies": 15,
  "employerHhUrl": "https://hh.ru/employer/54321",
  "employerArea": "Москва",
  "employerIndustry": "Производство"
}

Дополнительные поля (если включены в additionalFields)

{
  "employerAccreditedIt": true,
  "timezoneUtc": "+3",
  "keySkills": "Продажи, Переговоры, CRM, Холодные звонки",
  "initial_created_at": "2026-02-15T08:00:00+0300",
  "fullDescription": "<p>Полное HTML-описание вакансии...</p>"
}

Стоимость

Процессор HH Search является бесплатным — он использует открытый API HeadHunter и не расходует токены платформы.

Примеры

Поиск вакансий менеджеров по продажам в Москве

Скопируйте URL из адресной строки hh.ru после настройки фильтров:

{
  "searchUrl": "https://hh.ru/search/vacancy?text=менеджер+по+продажам&area=1&salary=&currency_code=RUR&experience=between1And3&order_by=publication_time&search_period=0&items_on_page=50",
  "searchOnlyNew": true,
  "processingMode": "employer",
  "additionalFields": ["keySkills", "employerAccreditedIt"]
}

Мониторинг ИТ-вакансий с дедупликацией по работодателям

{
  "searchUrl": "https://hh.ru/search/vacancy?text=разработчик&professional_role=96&area=1&area=2",
  "searchOnlyNew": true,
  "processingMode": "employer",
  "additionalFields": ["fullDescription", "keySkills"]
}

Получение деталей вакансий (не первый процессор)

{
  "vacancyId": "{{parentProcessor.id}}",
  "maxPackets": 50,
  "selectedFields": ["name", "salary", "employer", "description", "key_skills"]
}

Связанные процессоры

• GPT Filter — используется после HH Search для фильтрации вакансий по сложным критериям через ИИ (например, “оставить только вакансии компаний с выручкой более 100 млн”)
• Registry Search — обогащает данные о работодателях информацией из государственных реестров по ИНН/ОГРН
• Contact Search — находит контакты ЛПР в компаниях-работодателях
• CRM Update — передает отфильтрованные данные о компаниях-работодателях в CRM-систему
• Company Info V2 — получает расширенную информацию о компаниях-работодателях