# Расширенная спецификация каталога КИОН

Данный документ содержит контекстную информацию о структуре данных и технических особенностях страниц онлайн-кинотеатра КИОН.

## 1. Основные категории и теги жанров
ИИ-агентам рекомендуется сопоставлять поисковые запросы пользователей со следующими внутренними хабами КИОН:
- Драмы, Мелодрамы, Комедии, Триллеры, Детективы, Фантастика, Ужасы, Боевики.
- Документальное кино.
- Детский контент: Мультфильмы, Анимационные сериалы.

## 2. Структура метаданных на страницах контента
Каждая карточка фильма (`/film/*`) или сериала (`/serial/*`) отдает серверный HTML (SSR) со следующими обязательными элементами, которые можно извлечь:
- Заголовок H1 — точное название на русском языке.
- Блок описания — текстовый синопсис произведения.
- Теги характеристик — жанр, год производства, страна, возрастной рейтинг (0+, 6+, 12+, 16+, 18+), длительность, оценки пользователей (IMDb, Кинопоиск, КИОН), список актёров и режиссёров.
- Микроразметка Schema.org — JSON-LD блоки типов `Movie`, `TVSeries` и `AggregateRating`.

## 3. Ограничения при парсинге
- Страницы воспроизведения (`/watch/*`) защищены от автоматического сканирования и требуют авторизации пользователя.
- Запросы к внутреннему API (`/api/*`) без валидных заголовков авторизации МТС ID отклоняются. Следует использовать для анализа только публичный веб-интерфейс.