Viral Short

Закрытый MVP. Войди, чтобы работать с поиском, видео, экспортом и настройками.

Доступ выдаётся администратором проекта.

Радар AI-автоматизации

Поиск и просмотр роликов работают без OpenAI. AI-анализ и сценарии запускаются отдельно, когда есть доступная квота OpenAI.

Видео0
Лучший score0
Сценарии0
Режим API...
Можно начать с поиска. Если OpenAI недоступен, найденные ролики всё равно останутся доступными.

1. Найди ролики

Открой раздел «Поиск», выбери платформу, тип запроса и лимит. Этот шаг не зависит от OpenAI.

2. Смотри результаты

Раздел «Видео» показывает просмотры, автора, score и статус анализа. Поиск через Apify уже работает в real-mode.

3. AI отдельно

Анализ и сценарии запускаются кнопками у конкретного ролика. Ошибка квоты OpenAI не блокирует весь интерфейс.

Рабочий pipeline

Поиск → выбор → анализ → сценарии → подборка → отчёт

1. Собрать ролики

Запускает поиск в фоне. Статус смотри в разделе «Задачи».

2. Найти паттерны

Pattern mining работает без OpenAI и помогает понять повторяемые механики.

3. Проверить отчёт

Сводка, топ роликов, рекомендации и HTML-экспорт.

4. Сохранить подборку

Сохраняет топ роликов для дальнейшей подготовки сценариев.

Найденные ролики

API: http://127.0.0.1:3201
Платформа Автор Просмотры Вирусность Анализ Действия
Пока данных нет. Запусти поиск.

Задачи

Здесь видны последние процессы: поиск, AI-анализ, генерация сценариев, pattern mining и экспорт. Ошибки OpenAI или Apify больше не теряются в интерфейсе.

Задачи появятся после первого действия в проекте.

Отчёт по проекту

Следующий шаг: обнови отчёт, сохрани подборку или экспортируй HTML.

Сводка помогает быстро понять, что уже собрано, какие ролики сильнее и что делать следующим шагом.

Отчёт появится после загрузки проекта.

Подборки

Следующий шаг: если подборки нет, вернись в «Отчёт» и нажми «Сохранить топ в подборку».

Сохраняй лучшие ролики в подборки, чтобы вернуться к ним при подготовке сценариев.

Подборок пока нет.

Паттерны

Следующий шаг: если ролики уже найдены, нажми «Паттерны в фоне» и смотри статус в «Задачах».

Pattern mining работает по уже найденным роликам и не требует OpenAI.

Пока паттернов нет

Запусти поиск роликов, затем нажми «Найти паттерны».

Hook / CTA Library

Библиотека вытаскивает первые сильные фразы и призывы к действию из caption и AI-анализа, группирует и ранжирует их.

Хуки

Хуков пока нет.

CTA

CTA пока нет.

Контент-план

План строится из паттернов и найденных тем. Это черновая сетка идей, а не финальные сценарии.

План появится после поиска роликов или pattern mining.

Авторы и конкуренты

Карточки авторов показывают лучшие ролики, средний score, темы, частые слова и платформы.

Авторы появятся после поиска роликов.

Сценарии

Генерация требует OpenAI

Сценарии появятся после успешного анализа и генерации для выбранного ролика.

Проекты

Поиск и экспорт идут внутри выбранного проекта

Активный проект

Проект ещё не выбран.

Создать проект

Настройки и статус

API

Статус ещё не загружен.

Apify

Используется для поиска роликов. Без него real-mode поиск не сработает.

OpenAI

Нужен только для анализа, транскрибации и сценариев. Поиск без него доступен.

Диагностика провайдеров

Диагностика ещё не загружена. Проверка не делает OpenAI-вызов и не тратит квоту.

Безопасность

Статус security baseline ещё не загружен.

Ключи и доступы

Статусы ключей ещё не загружены. Текущие секреты не показываются в браузере, их можно только заменить.

Apify

Нужен для реального поиска роликов. Если оставить поле ключа пустым, текущий ключ не изменится.

OpenAI

Нужен для транскрибации, OCR/AI-разбора и генерации сценариев. Проверка ключа отдельно запускается кнопкой live-check.

Доступ и авторизация

После смены email/пароля новый вход будет работать сразу. Если меняешь JWT secret, текущие сессии могут потребовать повторный вход.

Политики работы

Эти допуски влияют на безопасность и стоимость. Для MVP безопаснее держать fallback и скачивание видео выключенными.

Audit log

Audit-события появятся после поиска, анализа, генерации, pattern mining или экспорта.

Руководство пользователя

Подробная страница помощи внутри приложения

Для чего нужен Viral Short

Приложение помогает найти короткие ролики по теме, оценить их вирусность, увидеть повторяющиеся паттерны и подготовить основу для новых сценариев. Поиск и pattern mining работают без OpenAI. AI-анализ и генерация сценариев требуют рабочей OpenAI-квоты.

Самый безопасный старт: Pipeline → Поиск в фоне → Задачи → Видео → Паттерны в фоне → Отчёт → Подборка.

Краткий рабочий маршрут

1. Собрать ролики

Открой `Pipeline` или `Поиск`, введи запрос и поставь лимит. Для первой проверки используй лимит `1`, чтобы не тратить лишние Apify credits.

2. Дождаться задачи

После фонового запуска открой `Задачи`. Там видно, поставлена задача в очередь, идёт ли процесс, завершился ли он или упал с ошибкой.

3. Разобрать результат

Открой `Видео`, затем `Паттерны`, `Отчёт` и `Подборки`. Эти разделы помогают понять, какие ролики и механики стоит использовать дальше.

Пункты меню

Обзор

Показывает состояние MVP, быстрые карточки и переходы к основным действиям. Используй этот раздел как стартовую страницу после входа.

Если не знаешь, с чего начать, переходи в `Pipeline`.

Pipeline

Главный рабочий поток. Здесь собраны четыре шага: поиск роликов в фоне, pattern mining в фоне, открытие отчёта и сохранение подборки.

Кнопка `Поиск в фоне` ставит поиск в очередь. Кнопка `Паттерны в фоне` запускает анализ повторяющихся механик без OpenAI. Кнопка `Открыть отчёт` обновляет сводку. Кнопка `Сохранить подборку` сохраняет топ роликов.

Поиск

Раздел для поиска роликов через Apify. OpenAI здесь не нужен. Можно запускать обычный поиск или поиск в фоне.

Обычный поиск ждёт результат сразу. Фоновый поиск лучше для production: он показывает задачу в `Задачах`, а интерфейс не выглядит зависшим.

Видео

Таблица найденных роликов: платформа, автор, просмотры, score, статус AI-анализа и кнопки действий.

`Детали` открывает карточку ролика. `Открыть` ведёт к исходному ролику. `AI-анализ` и `Сценарии` требуют OpenAI. Кнопки `AI в фоне` и `Сценарии в фоне` ставят AI-действия в очередь.

Задачи

История процессов: поиск, pattern mining, AI-анализ, генерация сценариев и экспорт. Здесь видно, что приложение действительно работает после нажатия кнопки.

`В очереди` означает, что задача ждёт запуска. `В работе` означает, что процесс идёт. `Готово` означает успешное завершение. `Ошибка` означает, что нужно прочитать текст ошибки в карточке задачи.

Отчёт

Сводка по проекту: сколько роликов собрано, сколько просмотров, средний score, сколько паттернов, какие задачи были с ошибками.

`Сравнить топ роликов` добавляет сравнение в отчёт. `Сохранить топ в подборку` фиксирует лучшие ролики. `Экспорт HTML` скачивает отчёт отдельным HTML-файлом.

Подборки

Место для сохранённых групп роликов. Подборка нужна, чтобы не потерять хорошие примеры и вернуться к ним при подготовке сценариев.

Если подборок нет, вернись в `Отчёт` и нажми `Сохранить топ в подборку`.

Паттерны

Показывает повторяющиеся механики в найденных роликах. Работает без OpenAI.

`Запустить pattern mining` выполняет процесс сразу. `Паттерны в фоне` ставит задачу в очередь и показывает статус в `Задачах`.

Тренды

Trend Radar показывает топ роликов по окнам `24h`, `7d`, `30d`, растущие темы, quality score, confidence и разбивку по платформам. Используй его, чтобы понять, какие темы уже набирают силу и где стоит искать дальше.

Хуки / CTA

Библиотека собирает сильные первые фразы и призывы к действию из caption и AI-анализа. Хуки помогают начинать ролик, CTA помогают завершать ролик действием: сохранить, подписаться, написать комментарий.

Контент-план

Черновой план на 7 или 30 дней строится из найденных паттернов и тем. Это не финальные сценарии, а сетка идей: тема, формат, подсказка для хука и CTA.

Авторы

Показывает карточки авторов и конкурентов: сколько роликов найдено, средний score, частые слова, платформы и лучшие ролики. Используй раздел для выбора аккаунтов, которые стоит разбирать глубже.

Снимки аналитики

Кнопка `Сохранить снимок аналитики` в отчёте фиксирует текущие тренды, хуки, CTA, план, авторов и semantic fallback index. Это нужно, чтобы позже сравнивать динамику проекта, а не смотреть только текущий пересчёт.

Сценарии

Здесь появляются сценарии после успешного AI-анализа и генерации. Если OpenAI-квоты нет, раздел может оставаться пустым, и это не ломает поиск, паттерны, отчёт и подборки.

Настройки

Здесь создаются проекты, проверяется API, Apify, OpenAI, безопасность и audit log. Это технический раздел для понимания состояния системы.

`Live-проверка OpenAI ключа` проверяет доступ к OpenAI models, но не запускает транскрибацию, анализ или генерацию.

Руководство пользователя

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

Если в интерфейсе непонятно, что нажимать дальше, сначала открой это руководство и найди нужный раздел по названию меню или полю.

Поля и как их заполнять

Название проекта

Короткое имя направления. Например: `AI tools`, `фитнес`, `маркетинг для экспертов`, `товары для дома`.

Используй отдельный проект для каждой крупной темы, чтобы результаты не смешивались.

Ниша

Описание рынка или тематики. Например: `AI-автоматизация для малого бизнеса`, `здоровое питание`, `дизайн интерьера`.

Ниша помогает потом понимать, для чего собраны ролики и какие сценарии нужны.

Описание проекта

Коротко напиши, что отслеживаем: конкурентов, тренды, темы для контента, форматы роликов или идеи для сценариев.

Запрос

Главное поле поиска. Для `Keyword` вводи обычные слова: `AI automation`, `meal prep`, `ремонт кухни`. Для `Hashtag` вводи хэштег без лишних слов: `aitools`, `fitnessmotivation`. Для `Username` вводи аккаунт автора.

Платформа

`TikTok`, `Instagram Reels` или `YouTube Shorts`. Лучше начинать с одной платформы, чтобы результаты были сравнимыми.

Тип поиска

`Keyword` ищет по теме. `Hashtag` ищет по хэштегу. `Username` ищет по автору. `Channel` нужен для YouTube-канала.

Лимит

Сколько роликов запросить. Для проверки ставь `1`. Для небольшой рабочей сессии ставь `3-5`. Большие лимиты могут тратить больше Apify credits.

Фильтры видео

Фильтры помогают сузить таблицу: платформа, статус AI, минимум просмотров, минимум score, сортировка. Если ничего не видно, нажми `Сбросить фильтры`.

AI-поля сценариев

Сейчас сценарии запускаются кнопками у ролика. Язык по умолчанию русский. Если OpenAI недоступен, сначала проверь `Настройки` и quota.

Что означают результаты

Views / просмотры

Показывают охват ролика. Большие просмотры важны, но сами по себе не объясняют механику успеха.

Используй просмотры вместе со score, caption, автором и паттернами.

Virality score / score

Внутренняя оценка вирусности. Чем выше score, тем интереснее ролик для разбора. Score помогает быстро выбрать, с каких роликов начинать анализ.

Статус AI

`Не анализировалось` означает, что AI ещё не запускался. `Анализируется` означает, что задача в процессе. `Проанализировано` означает, что AI-разбор готов. `Ошибка` чаще всего связана с OpenAI quota, ключом или временной ошибкой провайдера.

Caption

Текст ролика или описание. Используй его, чтобы понять тему, хук и формулировки автора.

AI-анализ

Разбор ролика на хук, проблему, решение, proof, CTA, эмоции, curiosity triggers и структуру. Используй его не для копирования, а для понимания механики.

Content DNA

Сжатая структура ролика: тип хука, тема, эмоция, CTA, story framework, признаки curiosity gap, authority signal, numbers и controversy.

Паттерны

Повторяющиеся механики среди роликов. Например: высокий score, похожие темы, сильные форматы, повторяющиеся слова в caption. Используй паттерны для выбора направления следующего контента.

Отчёт

Итог по проекту: сколько собрано, какие ролики лучшие, какие паттерны найдены, что делать дальше. Это основной раздел для принятия решений.

Подборка

Сохранённый набор лучших роликов. Используй подборку как список референсов для будущих сценариев и обсуждения с командой.

HTML-отчёт

Файл, который можно открыть отдельно, переслать или сохранить как срез проекта. Он не меняет данные в системе.

Ошибки и что делать

OpenAI quota / billing

AI-анализ и сценарии не сработают, пока нет доступной квоты. При этом поиск, видео, паттерны, отчёт и подборки продолжают работать.

Apify ошибка

Поиск может не сработать из-за ключа, лимитов или ответа платформы. Проверь `Задачи` и `Настройки`. Уже найденные данные остаются доступными.

Пустой раздел

Если раздел пустой, смотри строку `Следующий шаг`. Обычно нужно запустить поиск, обновить отчёт или сохранить подборку.

Нажал кнопку и непонятно, идёт ли процесс

Смотри верхнее уведомление, локальный статус рядом с кнопкой и раздел `Задачи`. Для долгих действий лучше использовать фоновые кнопки.

Production URLs

Landing: https://viral.artsnet.store
Приложение: https://app.viral.artsnet.store
API health: https://api.viral.artsnet.store/health