hh-mcp-ru

API hh.ru для ИИ-ассистентов: вакансии, отклики и приглашения, резюме, справочники, статистика зарплат. Каталог из официальной спеки, у каждого метода класс доступа.

Каталог собран из первоисточника (официальная спека api.hh.ru/openapi/specification/public) и лежит в репозитории как hh_mcp/endpoints.yaml: 133 метода, из них 92 на чтение, 32 на запись и 9 необратимых. Сервер исполняет ровно этот файл, поэтому таблица ниже не может разойтись с кодом.

Установка

uvx hh-mcp-ru

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "hh-mcp": {
      "command": "uvx",
      "args": ["hh-mcp-ru"],
      "env": { "HH_TOKEN": "...", "HH_APP_NAME": "..." }
    }
  }
}

Ключи

dev.hh.ru → Мои приложения → создать приложение → access token. HH_APP_NAME заполняется обязательно: hh отклоняет запросы без внятного User-Agent, и это первая причина непонятных ошибок 400.

переменная	секрет	что это
`HH_TOKEN`	да	Токен приложения hh.ru (dev.hh.ru → Мои приложения).
`HH_APP_NAME`	нет	Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в ~/.ru-mcp/cabinets.json с правами 600, вне репозитория.

Карта методов

раздел	методов	чтение	запись	необратимое
Работодатель и менеджеры	30	23	5	2
Вакансии	21	12	7	2
Общие справочники	14	6	7	1
Подсказки	11	11	0	0
Отклики и приглашения	10	5	5	0
Сохранённые поиски	6	2	3	1
Статистика зарплат	5	5	0	0
Вебхуки	4	1	2	1
Комментарии к соискателю	4	1	2	1
Резюме	3	3	0	0
Звонки	3	3	0	0
Регионы	3	3	0	0
Токены	2	0	1	1
Учебные заведения	2	2	0	0
Локали	2	2	0	0
Метро	2	2	0	0
Текущий пользователь	1	1	0	0
Аккаунты менеджеров	1	1	0	0
Отрасли	1	1	0	0
Словари	1	1	0	0
Профессиональные роли	1	1	0	0
Языки	1	1	0	0
Навыки	1	1	0	0
Clickme	1	1	0	0
Районы	1	1	0	0
Шаблоны сообщений	1	1	0	0
Условия публикации вакансий	1	1	0	0
всего	133	92	32	9

Как это выглядит в чате

Вы: поиск вакансий

hh_search_methods("поиск вакансий")
  hh_get_vacancies                     GET  /vacancies                                 чтение
  hh_get_vacancies_related_to_vacancy  GET  /vacancies/{vacancy_id}/related_vacancies  чтение
  hh_get_vacancies_similar_to_vacancy  GET  /vacancies/{vacancy_id}/similar_vacancies  чтение

hh_describe_method("hh_get_vacancies")
  Поиск по вакансиям
  GET api.hh.ru/vacancies
  параметры: page, per_page, text, search_field, experience, employment, schedule, area и ещё 36
  класс доступа: чтение

hh_call_method("hh_get_vacancies", {"page": "...", "per_page": "..."})

Три инструмента вместо 133 функций: агент ищет метод словами, читает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.

Что обычно просят:

Выгрузить свои вакансии и отклики за период и свести в таблицу.
Посмотреть статистику зарплат по роли перед публикацией вакансии.
Найти вакансии конкурентов по региону и профессиональной роли.
Ответить кандидатам шаблоном, показав список человеку до отправки.

Безопасность

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

Проверить установку

uvx hh-mcp-ru doctor

Печатает, сколько методов загрузилось, найдены ли ключи и откуда. Секреты не показывает. С --live делает один дешёвый реальный вызов на чтение.

Родня

Ядро вынесено в schema-mcp-core. Соседние серверы: vk-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru. Маркетплейсы живут отдельно: marketplaces-mcp-ru.

MIT. Автор Илья Утов.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hh_mcp_ru-0.2.0.tar.gz (22.5 kB view details)

Uploaded Sep 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

hh_mcp_ru-0.2.0-py3-none-any.whl (17.8 kB view details)

Uploaded Sep 11, 2026 Python 3

File details

Details for the file hh_mcp_ru-0.2.0.tar.gz.

File metadata

Download URL: hh_mcp_ru-0.2.0.tar.gz
Upload date: Sep 11, 2026
Size: 22.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hh_mcp_ru-0.2.0.tar.gz
Algorithm	Hash digest
SHA256	`6541cc69b8e8dc47af4816073c5ebbd271791c7bcf855897e8e4f8c7c8a8c5fc`
MD5	`48349971419c6fc32c73f9825d170fa7`
BLAKE2b-256	`ffd05a757fe912a3c7fa0444db4c9bd1572754dc8cf2f71eba4ec8f8d4e06317`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hh_mcp_ru-0.2.0.tar.gz:

Publisher: publish-pypi.yml on ilyautov/hh-mcp-ru

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hh_mcp_ru-0.2.0.tar.gz
- Subject digest: 6541cc69b8e8dc47af4816073c5ebbd271791c7bcf855897e8e4f8c7c8a8c5fc
- Sigstore transparency entry: 2792485918
- Sigstore integration time: Sep 11, 2026
Source repository:
- Permalink: ilyautov/hh-mcp-ru@b042a1a22a71add14797d2f94750f17025a52018
- Branch / Tag: refs/tags/v0.2.0
- Owner: https://github.com/ilyautov
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@b042a1a22a71add14797d2f94750f17025a52018
- Trigger Event: push

File details

Details for the file hh_mcp_ru-0.2.0-py3-none-any.whl.

File metadata

Download URL: hh_mcp_ru-0.2.0-py3-none-any.whl
Upload date: Sep 11, 2026
Size: 17.8 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hh_mcp_ru-0.2.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`051caed091132a5814820ce21e1a90d41e957bdf29335a5ed42ab3e100c8eab3`
MD5	`50850aec9ac2c19d162f6a0c870f5e18`
BLAKE2b-256	`36284258001e2755ee5848a2643ca80c13a6ec7889c7fa1c2f93211b74efa8bb`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hh_mcp_ru-0.2.0-py3-none-any.whl:

Publisher: publish-pypi.yml on ilyautov/hh-mcp-ru

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hh_mcp_ru-0.2.0-py3-none-any.whl
- Subject digest: 051caed091132a5814820ce21e1a90d41e957bdf29335a5ed42ab3e100c8eab3
- Sigstore transparency entry: 2792485945
- Sigstore integration time: Sep 11, 2026
Source repository:
- Permalink: ilyautov/hh-mcp-ru@b042a1a22a71add14797d2f94750f17025a52018
- Branch / Tag: refs/tags/v0.2.0
- Owner: https://github.com/ilyautov
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@b042a1a22a71add14797d2f94750f17025a52018
- Trigger Event: push

Release history Release notifications | RSS feed

This release

0.2.0 This release

Sep 11, 2026 2 files

0.1.1

Sep 11, 2026 2 files

0.1.0

Sep 11, 2026 2 files

hh-mcp-ru 0.2.0

hh-mcp-ru

Установка

Ключи

Карта методов

Как это выглядит в чате

Безопасность

Проверить установку

Родня

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Provides Extra

Tags

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed