---
name: ru-hh-vacancy-details
description: Анализ вакансии hh.ru для российского сервиса HeadHunter
version: 1.0.0
source: https://api.hh.ru/openapi/redoc
---

# Анализ вакансии hh.ru

Используй этот скилл, когда пользователь просит выполнить задачу в HeadHunter: Получить полную карточку вакансии и справочные значения.

## Перед началом

1. Открой актуальную официальную документацию: https://api.hh.ru/openapi/redoc
2. Уточни целевой аккаунт, объект, период и ожидаемый результат.
3. Проверь авторизацию: OAuth-токен пользователя или приложения и обязательный User-Agent.
4. Никогда не проси вставлять секрет в чат и не выводи его в команды, логи или ответ.

## Порядок работы

1. Сначала выполни доступный read-only запрос и проверь идентификаторы объектов.
2. Учитывай пагинацию, лимиты, актуальную версию API и повтор с backoff для 429/5xx.
3. Выполни задачу: Получить полную карточку вакансии и справочные значения.
4. Для повторяемой записи используй идемпотентность либо предварительную проверку текущего состояния.
5. После изменения перечитай объект через API и сравни фактическое состояние с запросом пользователя.
6. Верни краткий отчёт: что изменено, идентификаторы, ошибки и что осталось сделать вручную.

## Ограничения безопасности

- Перед удалением, публикацией, денежной операцией, запуском рекламы или необратимой сменой статуса получи явное подтверждение.
- Не расширяй права токена и не работай с аккаунтами, которые пользователь не указал.
- Не обходи модерацию, тарифные ограничения, rate limits и правила обработки персональных данных.
- Если документация расходится с памятью или примером, следуй текущей официальной документации.

## Источник

- https://api.hh.ru/openapi/redoc
- Исходный Agent Skill: https://github.com/hhru/api
