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

Базовый вызов

result = client.analyze(
    own_page="https://example.com/page",
    competitors=["https://comp1.com", "https://comp2.com"],
)

Все параметры

result = client.analyze(
    own_page: str,                          # URL вашей страницы (обязателен)
    competitors: List[str],                 # URL конкурентов — 3-10 рекомендуется (обязателен)
    queries: Optional[List[str]] = None,    # Целевые поисковые запросы (до 5)
    lang: Literal['ru', 'en'] = 'ru',      # Язык страницы
    url_cookies: Optional[Dict[str, str]] = None,  # Авторизационные cookie на URL
    triplet_analysis: bool = False,         # Включить граф знаний (5 кредитов)
    verbose: bool = False,                  # Показывать tqdm прогресс-бар
)

queries — целевые запросы

Почему запросы важны

Запросы определяют, какие слова используются как якорные точки для зонтичного анализа. Все леммы запросов объединяются и используются для нахождения контекстно важных слов на каждой странице. Без запросов зонтичный анализ не имеет якорных точек и может вернуть мало результатов или ничего.

result = client.analyze(
    own_page="https://example.com/mattress",
    competitors=["https://comp1.com/mattress", "https://comp2.com/sleep"],
    queries=[
        "купить матрас онлайн",
        "ортопедический матрас 180x200",
        "лучший пружинный матрас",
    ],
)

До 5 запросов. Чем больше — тем лучше: больше целевых запросов даёт больше точек охвата в HTML.

lang

Влияет на лемматизацию и корпус для анализа частот.

Значение	Язык
'ru'	Русский (по умолчанию)
'en'	Английский

При lang='en' значения action в block_comparison возвращаются на английском (add, increase, decrease, ok).

url_cookies

Для страниц за авторизацией или гео-блокировками:

url_cookies = {
    "https://example.com/private-page": "session=abc123; region=ru",
    "https://comp.com/restricted": "auth=xyz",
}

triplet_analysis

Стандартный режим (1 кредит) покрывает лексический анализ. Расширенный режим (5 кредитов) дополнительно извлекает граф знаний со всех страниц конкурентов:

result = client.analyze(
    own_page=..., competitors=...,
    triplet_analysis=True,  # добавляет triplets_analysis в result
)

Используйте расширенный режим, когда нужно:

• Бриф контента на уровне фактов (какие сущности и свойства освещены конкурентами)
• E-E-A-T / аудит полноты
• Анализ тематических пробелов на уровне сущностей (критические / важные / уникальные)

Длительность анализа

Режим	Типичное время
Стандартный	30–90 секунд
Расширенный (триплеты)	60–180 секунд

Длительность зависит от объёма страницы, числа конкурентов и нагрузки сервера.

Кредиты

Режим	Кредиты
Стандартный	1 кредит за анализ
Расширенный	5 кредитов за анализ

Проверьте баланс перед дорогостоящими анализами:

limits = client.get_limits()
print(f"Осталось сегодня: {limits['remaining_today']}")

Повторы при сетевых ошибках

client = UnihraClient(api_key="ВАШ_КЛЮЧ", max_retries=3)

Повторяет запросы при кодах 429, 500, 502, 503, 504 с экспоненциальной задержкой.