🔵 Production multi-tenant (архивный)
sargonpiraev — зрелая архитектура с OAuth-фасадом, тестами, полным покрытием API. Архивирован → ценен как референс, не как основа.
Документ для команды: как сегодня устроена интеграция с HH.ru, какие готовые инструменты существуют, что они умеют и чем отличаются, что разрешено и сколько стоит — и какие в итоге есть способы реализации. Без кода: только разбор, сравнение и решения.
Исторически HH имел открытый API с тремя уровнями доступа. На нём выросла экосистема: ATS (Huntflow, Talantix), скрипты, AI-ассистенты, MCP-серверы. 15 декабря 2025 HH закрыл сторону соискателя — официальная мотивация «борьба с мошенничеством и нерелевантными авто-откликами». Любая автоматизация от имени кандидата через API перестала работать; employer-сторона осталась открытой.
| Аспект | Employer-side (автоматизация HR) | Job-seeker-side (помощник кандидата) |
|---|---|---|
| Цель | работа рекрутера/компании | поиск работы за кандидата |
| Действия | публикация вакансий, поиск резюме, приглашения, ответы на отклики, аналитика воронки | поиск вакансий, авто-отклики, чтение переписок |
| Статус API | открыт после 15.12.2025 | закрыт 15.12.2025 |
| Требования | юр.лицо (ИП/ООО) + employer-подписка HH | — |
| Альтернативы | — | только UI-эмуляция (серая зона, три слоя риска) |
Доступность функций определяется уровнем авторизации. Важно для оценки сроков и затрат: значительную часть можно проверить без юр.лица и без денег; компания и подписка нужны только на финальной employer-стадии.
Без авторизации (нужен только корректный заголовок-идентификатор приложения). Доступны: справочники, подсказки, поиск и просмотр вакансий, публичная информация о работодателях, гео-справочники. Стоимость: 0 ₽.
Регистрация приложения в кабинете разработчика HH не требует юр.лица — нужен обычный аккаунт. После одобрения — самостоятельная генерация токена из интерфейса. Даёт расширенный read поверх anonymous. Стоимость: 0 ₽. Срок модерации: обычно ~4 рабочих дня, в редких случаях до 15.
Все «полезные» employer-методы (поиск резюме, приглашения, переписка, статистика воронки, вебхуки). Требует: верифицированный employer-аккаунт (ИНН/ОГРН), с 01.03.2026 — идентификацию через Госуслуги/ЕСИА (41-ФЗ), employer-подписку (от 25 000 ₽/мес). 41-ФЗ: publication.pravo.gov.ru/document/0001202503010001 · цены — см. §6
| Возможность | Авторизация | Статус |
|---|---|---|
| Поиск вакансий, детали, похожие | anonymous | открыт |
| Справочники, регионы, индустрии | anonymous | открыт |
| Публичная информация о работодателе | anonymous | открыт |
| Создание и управление вакансиями | employer | открыт |
| Отклики на свои вакансии, переписка, статистика | employer | открыт |
| Поиск в базе резюме | employer + подписка | открыт |
| Вебхуки на employer-события | employer | открыт |
| Отклик соискателя, чтение своих переписок, AI-агент кандидата | job-seeker | закрыт 15.12.2025 |
| HTML-скрейпинг страниц | — | запрещён правилами |
Главный практический вопрос — не надо ли строить с нуля. Ниже — что уже существует на рынке и чем отличается. Официального решения от HH нет; всё — community-проекты разной зрелости.
MCP — стандарт, по которому LLM-агент (Claude и др.) получает «инструменты». Для HH есть несколько community-серверов:
| Проект | Язык | Сторона | Подход | Зрелость | Статус |
|---|---|---|---|---|---|
| mardanaltynbekov1104/hh-mcp 🏆 | TypeScript | employer | прямой API, мультиплощадка | очень свежий, без тестов | active |
| gmen1057/headhunter-mcp-server 🥈 | Python | обе | прямой API | 14★, простой, ~400 строк | active |
| sargonpiraev/hh-mcp-server | TypeScript | обе | OAuth-фасад, codegen, 167+ инстр. | production-grade, тесты+CI | archived |
| Vadtop/hh-mcp-server | Python | job-seeker | UI-эмуляция (Playwright) | зрелый, 60 тестов, anti-bot | active |
| iraguzov/hh-mcp-server | Python | job-seeker | UI-эмуляция | компактный, без лицензии | slow |
| jacintacaryophyllaceous404/hh-ru-apply | JS | job-seeker | UI-эмуляция + LLM-скоринг | самый свежий, сырой | fresh |
| Obure22/SecondHackaton-HackAI | Python | обе | хакатон | не для production | — |
Официальный API, легально для бизнеса. mardanaltynbekov (employer-only с рождения, мультиплощадка, авто-обновление токена) и gmen1057 (обе стороны — лишнее надо убирать).
sargonpiraev — зрелая архитектура с OAuth-фасадом, тестами, полным покрытием API. Архивирован → ценен как референс, не как основа.
Появились после закрытия API. Нарушают правила. Vadtop — самый зрелый (anti-bot, скоринг, защита от повторов).
Хакатонные/сырые поделки — для полноты картины, не для использования.
| Вариант | Что это | Когда уместно |
|---|---|---|
| Apify-скрейперы | SaaS HTML-парсеры | массовый read-only сбор; готовы платить и принять нарушение правил |
| Claude Code Skills | текстовые инструкции агенту + встроенный веб-доступ, без отдельного сервера | advisor-сценарии, прототип, анонимный поиск |
| Готовые CLI-утилиты | напр. hh-applicant-tool (гибрид API + эмуляция) | личное использование, не коммерческое |
| Свой клиент поверх OpenAPI | генерация клиента из спецификации | полный контроль, production employer-интеграция |
Что предлагают сервисы «помощник кандидата» после закрытия API — и почему почти все либо мертвы, либо в серой зоне:
Стучится в закрытые API → ошибки доступа. Висит в магазине, но не работает.
Авто-отклики не реагируют, данные застыли.
Логин по SMS → парсит резюме через эмуляцию браузера от вашего имени. Глубокий анализ, но нарушает правила HH и 152-ФЗ; риск блокировки аккаунта.
Технически работает, но именно через него произошла репутационная катастрофа (см. ниже).
Не запрашивает логин/пароль HH, не делает действий за пользователя. Только анализ совпадения резюме↔вакансия, генерация писем, оценка рисков, подготовка к собеседованию, воронка откликов. Единственный работоспособный безопасный вариант.
| Слой | Что происходит | Кто видит |
|---|---|---|
| 1. Правила HH | детект паттерна → блокировка аккаунта, IP, капчи | анти-бот HH |
| 2. 152-ФЗ / ст. 272.1 УК | незаконная обработка ПДн → штрафы до 5 млн, до 5 лет | регуляторы при проверке |
| 3. Репутация в ATS | паттерн «1000 откликов» = метка «СПАМ» во всех системах | все рекрутеры на рынке |
Третий слой самый коварный: даже без блокировки HH и без проверки регуляторов репутация уничтожается необратимо — это не «риск», а гарантированный результат массовой автоматизации.
| Статья | Стоимость | Примечание |
|---|---|---|
| Регистрация ИП (если нет юр.лица) | 800–5 000 ₽ | ~1 неделя |
| Employer-аккаунт HH | бесплатно | 1–3 дня верификация |
| Регистрация приложения | бесплатно | модерация ~4–15 дней |
| Employer-подписка (база резюме) | от 25 000 ₽/мес | базовый региональный пакет |
| Подписка (крупные нужды) | до 120 000 ₽/мес | зависит от региона и пакета |
| Контакты в активном поиске | 120–300 ₽/контакт | оплачиваются пакетами |
hh.ru/price-list · hh.ru/price/dbaccess · feedback.hh.ru/knowledge-base/article/0823 (доступ к базе резюме) · feedback.hh.ru/knowledge-base/article/1292 (тарифы публикации) · prorecruitment.ru/blog/tarify-hh-ru-dlya-rabotodateley
| Модель | За 1M токенов (вход/выход) | 1000 запросов/мес (оценка) |
|---|---|---|
| Sonnet | ~$3 / $15 | ~$30–50 |
| Opus | ~$15 / $75 | ~$150–250 |
docs.claude.com/en/docs/about-claude/pricing · claude.com/pricing (тарифы на момент ресёрча, сверять актуальные)
Для пилота и внутреннего использования Sonnet более чем достаточно. Инфраструктура (хостинг, БД, мониторинг) — в пределах бесплатных тарифов на старте.
На уровне выбора подхода (без деталей сборки) интеграция существует в четырёх формах. Выбор определяется стороной (employer / public / job-seeker) и типом действий (read-only / action).
read готов action под риском
Взять community-сервер (mardanaltynbekov / gmen1057) и подключить к агенту. Быстрый старт для employer-сценариев.
полный контроль
Сгенерировать клиент из официальной спецификации и обернуть нужные методы. Для production и кастомных сценариев.
advisor / прототип
Текстовые инструкции агенту + встроенный веб-доступ. Подходит для анализа и анонимного поиска; не для авторизованных действий.
серая зона
Единственный путь для job-seeker-действий после закрытия API. Нарушает правила, три слоя риска (§5). Для бизнеса не рекомендуется.
| Аспект | MCP-сервер | Claude Code Skills |
|---|---|---|
| Где живёт | отдельный процесс | текстовые файлы в проекте |
| Токены / состояние | сервер хранит, обновляет | stateless |
| Переносимость | Claude Code, Desktop, Cursor и др. | только Claude Code |
| Когда выбирать | production, авторизованные действия | read-only, прототип, advisor |
| Условие | Рекомендуемый способ |
|---|---|
| Employer-MVP, язык не критичен (наш кейс) | 🏆 взять за основу mardanaltynbekov |
| Жёсткое требование Python | gmen1057 + дописать недостающее |
| SaaS / несколько работодателей | паттерн sargonpiraev (OAuth-фасад) |
| Только аналитика рынка (read-only) | анонимные endpoint'ы напрямую — MCP не нужен |
| Job-seeker автоматизация (с принятием рисков) | Vadtop (UI-эмуляция) |