✓ Бесплатно · подключение за 5 минут

MCP-сервер для hh.ru

Подключите HeadHunter API к Claude Code, Cursor или любому ИИ-агенту через один эндпоинт: агент сам ищет вакансии, читает ваши отклики и данные работодателей — без написания кода интеграции и без установки локального сервера.

Подключить за 5 минут Документация

Бесплатно · ключи шифруются · инструменты только для чтения

Кому полезно

Соискателям — агент анализирует рынок под ваш профиль: находит подходящие вакансии, сравнивает требования с вашим резюме и следит за статусами откликов.
HR-специалистам и рекрутёрам — быстрый срез рынка: какие компании ищут таких же специалистов, какие зарплаты указывают в вакансиях конкуренты.
Аналитикам рынка труда — выборки по вакансиям hh.ru (регионы, зарплатные вилки, требования) прямо в диалоге с ИИ, без выгрузок и скриптов.
Разработчикам карьерных сервисов — прототипирование продуктов на данных HeadHunter API без написания собственного клиента и OAuth-обвязки.

Что спросить у агента

Никаких дашбордов и выгрузок — обычный вопрос в чате. Агент сам выберет нужные инструменты hh.ru, вызовет их и посчитает ответ.

Найди вакансии PHP-разработчика в Санкт-Петербурге с зарплатой от 250 000 рублей и удалёнкой, сведи в таблицу с работодателями и ссылками
Сколько сейчас вакансий по запросу «аналитик данных» в Москве и какая медианная зарплатная вилка в выдаче?
Покажи мои отклики за последние две недели: где резюме просмотрено, где приглашение, где отказ
Сравни требования в 10 свежих вакансиях Go-разработчика с моим резюме на hh.ru и скажи, каких навыков мне не хватает
Что известно о работодателе «Яндекс» на hh.ru: описание, отрасль, сколько открытых вакансий?
Собери список компаний, которые ищут DevOps-инженеров в Казани, с зарплатами из вакансий
…агент вызывает инструменты hh.ru и отвечает цифрами вашего аккаунта

Инструменты — только чтение

Технические детали — для разработчиков
Какие ключи нужны
OAuth 2.0: приложение регистрируется в личном кабинете разработчика dev.hh.ru, после чего доступны два типа токенов — токен приложения (публичные данные: поиск вакансий, справочники) и пользовательский access token (резюме, отклики). В кабинете Neurly достаточно вставить полученный токен — обвязку авторизации берём на себя.
Лимиты API
Точные rate-limits не публикуются: HeadHunter официально не раскрывает цифры, при слишком частых запросах API начинает отвечать ошибкой 403. MCP-сервер Neurly выполняет запросы в щадящем темпе.
Что учитываем за вас
  • Каждый запрос обязан содержать заголовок User-Agent с названием приложения и контактом — без него API возвращает ошибку.
  • Глубина поиска вакансий ограничена 2000 результатами, per_page — до 100 элементов на страницу; для больших выборок нужно сужать фильтры.
  • Поиск по базе резюме других людей доступен только работодателям с оплаченным доступом — соискательский токен даёт доступ лишь к собственным резюме и откликам.
  • Пользовательский access token имеет ограниченный срок жизни и обновляется по refresh token — hosted-сервер Neurly будет обновлять его автоматически.

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

1
Зарегистрируйтесь в Neurly
Без карты. MCP-вызовы бесплатны — баланс не расходуется.
2
Подключите hh.ru
Вставьте ключи hh.ru в разделе «MCP» кабинета Neurly — храним их в зашифрованном виде, инструменты появятся у агента.
3
Добавьте эндпоинт в клиент
Одна команда в Claude Code или пара строк конфига в Cursor — инструменты появятся у агента.
claude mcp add --transport http neurly https://neurly.ru/v1/mcp --header "Authorization: Bearer sk-neurly-..."
Начать бесплатно

Частые вопросы

Что такое MCP-сервер для hh.ru простыми словами?

Это «переходник» между HeadHunter API и вашим ИИ-агентом. Вы подключаете токен hh.ru в кабинете Neurly, прописываете один эндпоинт в Claude Code, Cursor или другом MCP-клиенте — и агент получает готовые инструменты: поиск вакансий, ваши отклики, карточки работодателей. Никакого кода писать не нужно.

Насколько это безопасно? Куда попадает мой токен hh.ru?

Токен хранится в зашифрованном виде и используется только для запросов к api.hh.ru от вашего имени. Все инструменты — строго read-only: агент не может откликаться на вакансии, редактировать резюме или писать работодателям. Отозвать доступ можно в любой момент на dev.hh.ru.

Сколько стоит MCP-сервер hh.ru от Neurly?

Бесплатно, и это навсегда: MCP-серверы — часть экосистемы Neurly, а не отдельный платный продукт. Нужен только аккаунт Neurly с положительным балансом; сам баланс на MCP-запросы не расходуется.

На GitHub уже есть MCP-серверы для hh.ru — чем вариант Neurly отличается?

Да, существуют community-проекты (например, headhunter-mcp-server), но их нужно устанавливать и запускать локально, самому вести OAuth и обновление токенов. Neurly даёт hosted-вариант: без установки, с шифрованием ключей, автообновлением токенов и одним эндпоинтом сразу для всех ваших интеграций — от hh.ru до Ozon Seller.

Нужен ли платный доступ к API hh.ru, чтобы пользоваться MCP-сервером?

Для большинства сценариев — нет. Поиск вакансий, карточки работодателей и справочники доступны бесплатно, свои резюме и отклики — по бесплатному пользовательскому токену. Платный доступ у hh.ru нужен только работодателям для поиска по чужим резюме — эта функциональность в базовый набор инструментов не входит.

Другие MCP-серверы

DaData Ozon Seller API Roistat Telegram Bot API Webasyst / Shop-Script Wildberries Битрикс24 Т-Банк (бизнес) Яндекс.Метрика 1С:Предприятие 2ГИС amoCRM API Яндекс.Карт Borzo (Достависта) BotHelp Boxberry Calltouch Carrot quest Chat2Desk Checko CloudPayments CoMagic DashaMail DPD Ecwid Frontpad GetCourse iiko InSales Jivo Kaiten Lamoda LiveDune Mindbox PromoPult Pyrus RetailCRM Robokassa Rusprofile RUTUBE Salebot Sendsay SMS.ru SMSC.ru SuperJob Tilda Topvisor UIS Unisender VK API VK Реклама Wazzup YCLIENTS YouGile Zadarma Авито Альфа-Банк (бизнес) АТОЛ Онлайн ВТБ (бизнес) Деловые Линии Контур.Диадок Контур.Фокус Контур.Экстерн Контур.Эльба Манго Офис Мегамаркет Мегаплан Модульбанк МойКласс МойСклад Московская биржа Моё дело МТС Exolve ПланФакт Планфикс Почта России ПЭК СберБизнес СБИС (Saby) СДЭК СПАРК-Интерфакс Т-Инвестиции Т-Касса Точка Банк Финолог Хантфлоу ЦБ РФ Честный ЗНАК Эвотор ЮKassa Юздеск Яндекс 360 Яндекс.Вебмастер Яндекс.Вордстат Яндекс.Директ Яндекс.Диск Яндекс.Доставка Яндекс.Маркет Яндекс.Трекер Все MCP-серверы →