video-analyzer

Что делает простыми словами

Это «приёмщик клипов». Если у тебя есть готовые видосы — со съёмки, с телефона клиента, скачанные из инстаграма конкурента, сгенерённые в Veo — analyzer их разглядывает и заносит в библиотеку проекта с правильным описанием. После этого director может их использовать в монтаже наравне с любыми другими.

1. Берёт видеофайл (один или пачку)
2. Извлекает 3-5 кадров (начало / середина / конец / ключевые моменты)
3. Прокидывает кадры через Vision — буквально смотрит что на них
4. Определяет scene_type (hook / product / lifestyle / testimonial / cta / transition) и mood (energetic / calm / dramatic / funny / luxury)
5. Пишет подробное описание — что в кадре, какое освещение, что за движение, какое настроение
6. Регистрирует в clips table + linкуeт к проекту через project_clips junction

Что analyzer умеет увидеть из кадров

Real-time видео он смотреть не может, но из 3-5 хорошо выбранных кадров вытаскивает:

• Объекты и люди в сцене
• Какое действие происходит (можно понять по разнице между frame 1 и frame 5)
• Тип плана: крупный / средний / общий / overhead
• Тенденция движения камеры: статика / pan / zoom
• Освещение и цветовая палитра
• Общее настроение и уровень энергии

Два режима работы

Scene types и moods

Scene type — выбирай один

Mood — выбирай доминанту

Описание — хорошее vs плохое

Команды

Извлечь кадры из одного клипа

python ~/.claude/skills/video-analyzer/scripts/extract_frames.py /path/to/video.mp4 \
  --output-dir ~/video-projects/apparatus/thumbnails \
  --frames 5

# → пути к 5 JPG-кадрам + метаданные (duration, resolution, fps)

Извлечь кадры пачкой

python ~/.claude/skills/video-analyzer/scripts/extract_frames.py \
  --batch /path/to/videos/ \
  --output-dir ~/video-projects/apparatus/thumbnails \
  --frames 3

Зарегистрировать клип в БД

python ~/.claude/skills/video-analyzer/scripts/register_clip.py \
  --project-dir ~/video-projects/apparatus \
  --filepath /path/to/video.mp4 \
  --description "Подробное описание после визуального анализа..." \
  --scene-type lifestyle \
  --mood calm \
  --tags "woman,vase,kitchen,warm" \
  --actions "places vase on table,camera holds" \
  --source upload

Для Veo-клипов

python ~/.claude/skills/video-analyzer/scripts/register_clip.py \
  --project-dir ~/video-projects/apparatus \
  --filepath /path/to/veo_clip.mp4 \
  --description "..." --scene-type hook --mood energetic \
  --source veo \
  --prompt "Original Veo prompt that generated this clip"

Перепроанализировать существующий клип

# 1. Берём текущую инфу
python ~/.claude/skills/video-analyzer/scripts/db_helper.py get-clip \
  ~/video-projects/apparatus 42

# 2. Извлекаем кадры заново
python ~/.claude/skills/video-analyzer/scripts/extract_frames.py \
  /path/to/existing_clip.mp4 \
  --output-dir ~/video-projects/apparatus/thumbnails --frames 5

# 3. Смотрим кадры → пишем новое описание → обновляем
python ~/.claude/skills/video-analyzer/scripts/db_helper.py update-clip \
  ~/video-projects/apparatus 42 \
  --description "Обновлённое описание..." \
  --scene-type hook --mood energetic

Скрипты

Параметры register_clip.py

Что попадает в БД

После register_clip в проектной director.db появляется запись в clips:

id              | 42
filename        | clip_042.mp4
filepath        | ~/video-projects/apparatus/clips/clip_042.mp4
thumbnail_path  | ~/video-projects/apparatus/thumbnails/clip_042_thumb.jpg
duration        | 6.0
width, height   | 1080, 1920
fps             | 30
description     | "Close-up рук женщины..."
scene_type      | lifestyle
mood            | calm
tags            | "woman,vase,kitchen,warm"
actions         | "places vase on table,camera holds"
source          | upload (или veo / remotion)
prompt          | NULL (или оригинальный Veo prompt)
created_at      | 2026-05-16T12:34:56

Link к проекту — через junction project_clips(project_id, clip_id). Один клип теоретически может быть прилинкован к нескольким проектам, но обычно scoped к одному.

Batch report

После пачки import показывай пользователю сводку:

• Сколько клипов импортировано успешно
• Разбивка по scene_type и mood
• Проблемные клипы — слишком короткие / тёмные / непонятный контент
• Каких типов теперь много, а каких всё ещё мало в library

Gotchas и tips

🎬 Примеры работы

Место в пайплайне

Сценарии вызова:

• Клиент дал свои съёмки — пачка через batch import
• Скачали референсные рилсы из инстаграма (через instagram-analyze скилл) — analyzer обрабатывает результат
• Clipgen сгенерил Veo-клип — internal вызов через analyze_clip.py для honest description
• Перепроанализировать старый клип — если описание устарело или было плохим