matriz-ver 是 matriz-viralidad 插件中的一个命令(/matriz-ver),用于分析单条视频的制作手法。它明确了一个前提:单条视频只能说明"怎么做的",不能说明"是否有效",因为没有账号完整数据就无法计算中位数,所以其 RENDIMIENTO 记为 s/d;若想判断表现,需使用 /matriz-espiar <handle> <red>。
用途 输入一个公开视频链接(YouTube、TikTok、Instagram、X 等)或本地视频文件,输出该视频的结构化拆解:hook 视觉与 hook 文字(转写的前 1–2 句原文)、前三秒发生了什么、整体结构、情绪、CTA、时长(由 ffprobe 实测而非估算)。仅支持公开视频;若链接属于私密账号或需要登录,工具会说明并停止。
主要能力 按环境自动选择分析路径,并按 C→A→B 的优先级:
- 路径 C(watch):已安装 watch 技能时可用,获取字幕或音频(Whisper)加关键帧;视频自带字幕时成本为 $0,使用 API 版 Whisper 时按所用供应商计费。
- 路径 A(Gemini):存在 GEMINI_API_KEY 且 MATRIZ_ANALIZADOR 非本地时,仅分析音频。资料给出约 $0.003–0.011 每个视频。
- 路径 B(关键帧):只要有 ffmpeg 即可用,只感知画面中可见的内容(如烧录字幕),API 成本 $0,约消耗 25k 上下文 token。 工具会先运行 node "<RAIZ>/scripts/revisar.mjs" todo 判断可用路径,并用一句话说明选择了哪条路径及原因。
使用方式
- 根路径判定:插件根目录为 ${CLAUDE_PLUGIN_ROOT};若显示为未替换的占位符,则为克隆模式,RAIZ 为当前目录(可用 ls scripts/apify.mjs 确认)。命令中的 <RAIZ> 替换为该值;人物数据始终保存在当前目录。
- 若派发子代理(espia、analista-video、matricero、simulador、validador 等)时找不到该名称,说明处于插件模式,需加前缀,如 matriz-viralidad:espia。
- 路径 C:通过 Skill(watch:watch) 传入链接,先请求 efficient 细节,再单独用 --start 0 --end 6 做一次聚焦前几秒的 hook 分析;随后按 .claude/agents/analista-video.md 第 4 步的规范写出 7 个键的 JSON,并附 _meta 字段(analyzer、hook 来源、时长来源、成本、备注、分析时间)。
- 路径 A/B:先把视频下载到 videos/(非直链可用 yt-dlp -o "videos/suelto-<id>.%(ext)s" "<url>"),再派发 analista-video 子代理并传入路径、RAIZ 与"单条视频"标记,由其选择 Gemini 或关键帧并写入 transcripciones/<id>.json。
- 结果保存为 transcripciones/suelto-<id>.json(同一 schema,RENDIMIENTO 不适用),并在对话中用最多 6 行概括 hook 原文、前三秒内容、结构、情绪、CTA 及所用路径;若走路径 B,还需说明因未听音频而丢失的信息。无法观察到的内容一律记为 s/d,且不得把文案说明当成 hook。
依赖与安装 watch 为独立插件(https://github.com/bradautomates/claude-video);如需路径 C,可执行: /plugin marketplace add bradautomates/claude-video /plugin install watch@claude-video 若使用 Whisper 需要用户提供密钥,工具只告知存放位置、不读取。Instagram 上 yt-dlp 有时需要 cookies,失败时可手动下载文件后用路径 B 处理。
适用场景 适合内容创作者、运营人员做单条视频的拆解复盘:看清开头钩子、叙事结构、情绪设计与行动号召,或对竞品单条内容做制作层面的观察。
限制 不提供播放表现结论(RENDIMIENTO 为 s/d);仅限公开视频;路径 B 看不到音频信息,只能依赖画面内字幕;Instagram 抓取可能受 cookies 限制;各路径成本取决于用户自身环境与供应商,资料未提供更多定价细���;接口、字段与脚本用法以资料原文为准。