English · Руководство · Установка на сервер · Релизы
Topic Radar — самостоятельный сервис для исследования тем и мониторинга роста видео. Введите запросы, выберите язык и формат: сервис найдёт публикации, сохранит метаданные и покажет, что набирает просмотры у каналов до 10 000 подписчиков. Порог можно изменить. Русский интерфейс; поиск с предпочтением русского или английского.
Без LLM, платной подписки и внешней аналитической платформы. Нужен собственный YouTube Data API key. База и настройки остаются у вас.
Первая публичная версия — MVP для одного владельца. Сигналы помогают выбрать видео для изучения; они не предсказывают число просмотров вашего будущего ролика.
| Возможность | Как помогает |
|---|---|
| Небольшие каналы | Рейтинг учитывает размер канала и измеренный прирост. |
| Два интервала | Поиск раз в 4–24 часа; замеры лидеров раз в 30–120 минут без повторного поиска. |
| Shorts и обычные видео | Раздельные исследования и фильтры. Shorts помечаются как оценка. |
| Метаданные | Название, описание, теги, хэштеги, реакции и исходный публичный JSON. |
| Видео и каналы | Каталоги, поиск, сортировка, страницы, графики и прирост в час. |
| Избранное | Заметки, обновление одной карточки или всех избранных объектов. |
| История и экспорт | Снимки, CSV / JSON / Markdown, копирование, корзина исследований. |
| Сервер и интеграции | Docker, вход владельца, шифрование ключей, HTTP API с отзываемыми токенами. |
Нужны Git и uv.
git clone https://github.com/Vangardo/content_radar.git
cd content_radar
.\setup.ps1
.\.venv\Scripts\python.exe -X utf8 -m app.local_setup
.\start.ps1Откройте http://127.0.0.1:8877. Команда настройки один раз покажет случайный пароль
владельца admin; сохраните его. В Настройках добавьте YouTube API key,
создайте исследование и запустите сканирование. Для повторных запусков достаточно start.ps1.
Подробная установка · Docker и HTTPS
.\.venv\Scripts\python.exe -X utf8 -m tests.preview_server --catalogОткройте http://127.0.0.1:8879, войдите как fixture-owner с паролем
fixture-password-123. Это демонстрация: временная база и синтетические данные,
запросы к YouTube не выполняются, реальные ключи вводить не нужно.
После остановки база удаляется. Сценарий демонстрации.
- Поиск находит до 50 / 100 / 200 / 500 видео на запрос. Совпавшие ID объединяются.
- Первый ответ сохраняет исходный счётчик. Просмотры за день — среднее за жизнь видео.
- Повторный ответ минимум через 30 минут даёт измеренный прирост в час.
- Монитор чаще обновляет сильные небольшие каналы и новых кандидатов. Широкий цикл пересматривает весь список, чтобы вернуть поздно растущие видео.
Темы объединяются простыми правилами и словарём. Формулы и ограничения — в руководстве.
По документации YouTube, по умолчанию проекту доступны 100 вызовов search.list и
10 000 единиц прочих методов в сутки; следующая страница — отдельный вызов.
Актуальные лимиты проверяйте в Google Cloud.
Источник: YouTube Quota Calculator.
- Это выборка результатов YouTube, а не обзор всей платформы. Язык — предпочтение поиска.
- API не возвращает надёжный флаг
isShort: сервис показывает оценку и неопределённые случаи. - Публичные API-данные хранятся 28 дней. Заметки и ID избранного — отдельно.
- Тексты комментариев и приватная аналитика владельцев каналов не запрашиваются.
- Один процесс, один владелец, одна SQLite. Многопользовательский SaaS и публикация видео не входят в эту версию.
- При перезапуске незавершённые операции помечаются прерванными; результаты сохраняются. Продолжение с контрольной точки пока не реализовано.
- Общих ключей и паролей в поставке нет. Для сервера нужны собственные секреты и HTTPS.
Python 3.11 · FastAPI · SQLite · обычный JavaScript. Готовый пакет — контейнер GHCR. Python-запуск выполняется из исходников; публикации в PyPI нет.
Архитектура · Участие и тесты · Безопасность · Изменения · План развития
MIT. Разработан на основе sentien-labs/youtube-niche: транспорт YouTube, кэш и часть обработки результатов. Исходный CLI сохранён для совместимости; его LLM-модули не вызываются веб-сервисом и не входят в зависимости Radar. Исходный снимок и изменения.
Проект не связан с YouTube или Google и не поддерживается ими.