CLI Reference

Синтаксис

unihra [--key KEY] [--limits] [--own URL] [--comp URL]... [OPTIONS]

Флаги

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

Коды выхода

Код	Значение
0	Успех
1	Ошибка API или сети
0	Прерывание пользователем (Ctrl+C)

Примеры

# Проверка баланса
unihra --key sk-xxx --limits

# Минимальный анализ — JSON в stdout
unihra --own https://example.com --comp https://comp.com

# Полный анализ с Excel-отчётом
unihra \
  --own https://example.com/product \
  --comp https://comp1.com/product \
  --comp https://comp2.com/product \
  --query "купить товар" \
  --query "лучший товар 2026" \
  --lang ru \
  --save report.xlsx \
  --verbose

# Граф знаний
unihra --own https://example.com --comp https://comp.com --triplets --save kg.xlsx

# Передача в jq
unihra --own https://example.com --comp https://comp.com | jq '.umbrella_analysis[:10]'