/analyze-video — Reference video analysis

Take a video — vertical reel, landscape clip, square ad, any aspect ratio, any duration — and produce a structured analysis of its hook, pacing, format, shot structure, and text overlay system. The analysis is the substrate the user creates against: once it lands, follow-ups like "draft a script that follows this template" work from the analysis JSON.

When to use

• The user pastes any video URL — Instagram Reel, YouTube Short or full video, TikTok, X/Twitter, or most public video sites.
• The user drops a local mp4 and asks "analyze this", "break this down", "what's the structure of this video".
• The user wants to study a reference video (short-form reel or long-form clip) before creating against it.

If the user just wants to play the video or glance at a frame or two, don't run the full pipeline — extract the frames they need and stop.

Prerequisites

Requires a vision-capable model — the analysis step reads frame mosaics as images.

ffmpeg + ffprobe are required. yt-dlp is only needed for the URL flow — local-file analysis works without it.