CLI

Утилита unihra позволяет запускать анализы и управлять аккаунтом без написания Python-кода.

Установка

pip install "unihra[full]"

Проверка баланса

unihra --key ВАШ_КЛЮЧ --limits

{
  "plan": "pro",
  "daily_limit": 5000,
  "used_today": 12,
  "remaining_today": 4988
}

Запуск анализа

unihra \
  --key ВАШ_КЛЮЧ \
  --own https://example.com/product \
  --comp https://comp1.com/product \
  --comp https://comp2.com/product \
  --query "купить товар онлайн" \
  --query "лучший товар 2026" \
  --lang ru \
  --verbose

Сохранить в Excel

unihra \
  --own https://example.com/product \
  --comp https://comp1.com \
  --query "целевой ключ" \
  --save report.xlsx \
  --verbose

Расширенный анализ (граф знаний)

unihra \
  --own https://example.com \
  --comp https://comp1.com \
  --comp https://comp2.com \
  --triplets \
  --save report_extended.xlsx \
  --verbose

Вывод JSON в stdout

unihra --own https://example.com --comp https://comp.com | jq '.umbrella_analysis[:5]'

Все флаги

Флаг	Описание	По умолчанию
--key	API-ключ (также работает env-переменная UNIHRA_API_KEY)	—
--own	URL вашей страницы	обязателен
--comp	URL конкурента (можно повторять)	обязателен
--query	Целевой запрос (можно повторять, до 5)	—
--lang	Язык: ru или en	ru
--cookies	Cookie авторизации для своей страницы: "session=abc"	—
--save	Имя файла вывода: .xlsx или .csv	stdout JSON
--triplets	Включить граф знаний (5 кредитов)	выкл
--limits	Показать баланс ключа и выйти	—
--verbose	Показывать прогресс и сводку	выкл
--no-style	Отключить цветовую разметку Excel	выкл
--retries	Число повторов HTTP-запросов	0

Переменная окружения

export UNIHRA_API_KEY="ваш_ключ"
unihra --own https://example.com --comp https://comp.com --verbose