SuperAPI AI 工具集

analyze

营销与增长

查看项目

更新于 10-29 06:02

技能介绍

用途 该技能用于对一个 TikTok、Instagram Reels 或 YouTube Shorts 视频做反向拆解:回答“这个视频为什么有效”以及“如何复刻”。用户提供单个视频 URL,或通过 /analyze <url> 调用;若未提供 URL,则向用户索取。

主要能力

  • 提取:调用脚本下载视频并输出 JSON,包含平台(tiktok/instagram/youtube)、元数据(标题、描述、上传者、时长、播放、点赞、评论、分享、互动率)、转写文本及其来源。
  • 音频转录:脚本下载视频后剥离音频,用 Groq whisper-large-v3-turbo 转写,因此即使视频没有字幕轨也能工作;平台字幕仅作回退。
  • 分析输出:依次给出数据面板、完整逐字稿、前 3 秒钩子分析(钩子类型、为何能阻止划走、改写钩子)、脚本结构分段(按叙事功能、时间估算、节奏与 but/therefore 视角)、风格标签(呈现形式、内容类型、情绪基调)、2-3 条具体爆款原因、3 个可执行改写方向(角度、钩子示例、最佳平台及理由)。
  • 结果沉淀:向本地 results 库追加一条记录(日期、上传者、标题/主题、平台、URL、数据、钩子类型、有效原因、改写角度),用于之后做跨视频模式分析。

使用方式

  1. 首次运行执行 bash ~/.claude/skills/analyze/scripts/setup.sh,需要 yt-dlp、ffmpeg、groq Python 包和 Groq key。
  2. key 从 GROQ_API_KEY 环境变量或技能本地文件 ~/.claude/skills/analyze/.groq_key 读取;两者都没有则停止并提示用户设置(可在 console.groq.com/keys 获取免费 key,并用 printf 写入 .groq_key 后 chmod 600)。注意导出的 GROQ_API_KEY 不会传递到该技能,因为 Claude Code 的 shell 不加载 ~/.zshrc。
  3. 运行 python3 ~/.claude/skills/analyze/scripts/analyze-video.py "$ARGUMENTS" 获取 JSON。
  4. 按 2.1-2.7 顺序输出 markdown,始终保留完整逐字稿,结尾附来源行。

回退策略 若元数据含 _error,先用 WebFetch 抓取视频 URL 提取元数据,或请用户粘贴脚本文字与数据(截图亦可);使用回退或转写来源为 caption/null 时,在输出顶部注明数据来源与完整度。无逐字稿时基于标题和描述推断钩子策略并标记低置信度,但仍交付分析。

适用场景 内容创作者、社媒运营、增长研究者做单条视频拆解、竞品分析、钩子改写与跨视频模式总结。

限制

  • 指标可靠性因平台而异:YouTube 较可靠,TikTok 部分可用,Instagram 通常为 N/A。
  • 缺失数据一律写 N/A,不编造;播放量缺失时跳过互动率计算。
  • 需要 Groq key 和上述命令行依赖;输出为英文,技术术语(hook、CTA、talking head)保留英文。