video-analyzer

视频分析器

分析视频并生成分镜拆解。通过场景检测提取帧，使用 Whisper 转录音频，使用 Claude Vision 分析画面，并计算 8 字段风格指纹。

功能

• 帧提取 — 基于场景检测选择关键帧（或按固定间隔提取）
• 音频转录 — 使用 OpenAI Whisper 生成带时间戳的转录文本
• 视觉分析 — 使用 Claude Vision 描述每一帧
• 风格指纹 v3 — 8 字段确定性分类（渲染类别、世界类型、角色策略、叙事结构、视觉抽象度、视觉密度、镜头语言、调性定位）
• 分镜输出 — 将逐镜头拆解汇总为 .docx 或 .md

MCP 服务

本项目包含 MCP（Model Context Protocol）服务，可直接通过 Claude Desktop 或 Claude Code 使用视频分析功能。

通过 Claude Code 安装

claude mcp add video-analyzer -s user -- uvx video-analyzer-mcp

通过 Claude Desktop 安装

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "video-analyzer": {
      "command": "uvx",
      "args": ["video-analyzer-mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "your-key-here"
      }
    }
  }
}

MCP 工具

工具	说明
video_analyze	完整流程：下载、提取帧、转录、分析、生成指纹和分镜
video_extract_frames	使用场景检测或固定间隔提取代表性帧
video_transcribe	使用 OpenAI Whisper 转录音频
video_fingerprint	生成 8 字段风格指纹 v3 分类
video_check_deps	验证是否已安装所有必需依赖

独立使用

pip install -r requirements.txt
python3 analyze_video.py "https://youtube.com/watch?v=..." --output-dir ./output

前置条件

• Python 3.10+
• FFmpeg — macOS 上使用 brew install ffmpeg 安装，或在 Linux 上使用 apt-get install ffmpeg
• ANTHROPIC_API_KEY — 设置为环境变量

风格指纹字段

1. 渲染类别 — 风格化 3D、扁平 2D、极简线稿、纹理 2D、混合媒介、照片级真实
2. 世界类型 — 风格化现实世界、抽象概念空间、数据／演示空间、虚构隐喻宇宙
3. 角色策略 — 无、吉祥物主导、单一旁白、单一主角弧线、群像
4. 叙事结构 — 直接说明、分步讲解、问题—解决方案、类比、破除迷思等
5. 视觉抽象指数 — 1（照片级真实）至 5（最大抽象度）
6. 视觉密度 — 极简、稀疏、适中、高
7. 镜头／剪辑语言 — 电影感、社交媒体竖屏冲击、演示文稿、静态幻灯片等
8. 调性定位 — 机构风格、企业专业风格、Z 世代社交风格、儿童友好、暗黑编辑风格

许可证

MIT