Analyze Clip
Comprehensive video clip analysis using the MCP tools.
Quick Start
Use the analyze_clip_unified tool:
Tool: analyze_clip_unified Args: { "videoPath": "data/video/clip.mp4" }
What It Detects
Signal Source Purpose
Scene changes ffmpeg scene detection Visual discontinuities
Black frames ffmpeg blackdetect Fades, dead regions
Freeze frames ffmpeg freezedetect Static frames, AI artifacts
Speech segments Whisper Audio activity
Dialogue match Comparison Validate generated speech
With Dialogue Context
Tool: analyze_clip_unified Args: { "videoPath": "data/video/clip.mp4", "context": { "dialogue": [ {"speaker": "marcus", "text": "Hello there"} ] } }
Available Analysis Tools
Tool Purpose
analyze_clip_unified
Full analysis (scenes, black, freeze, audio)
transcribe
Whisper transcription only
analyze_audio_timeline
Speech/silence detection
analyze_dialogue_clip
Compare expected vs actual dialogue
Interpreting Results
-
recommended_action : 'use_as_is', 'trim', 'review', or 'regenerate'
-
trim_recommendation : Suggested start/end times
-
anomalies : Issues found (with severity)
See .claude/rules/agents.md for full response schema.