video-content-analyzer

Video Content Analyzer 是一个短视频内容分析工具，基于 Gemini AI 对短视频进行拆解，提取钩子（hooks）、内容结构、表达风格（delivery style）以及 CTA 策略，并归纳可复制的模式。支持 Instagram Reels、TikTok 和 YouTube 平台。

主要能力

该分析器对每条视频输出以下分析维度：

钩子（hook）：识别钩子手法、开头文案、注意力抓取方式，并给出可复现的公式。
内容结构（content_structure）：识别内容格式、段落划分、节奏以及留存技巧。
表达风格（delivery_style）：如是否面对镜头、能量感、是否有文字覆盖、视觉风格等。
CTA 策略（cta_strategy）：CTA 类型、CTA 文案及出现位置。
为何有效（why_it_works）：对视频效果原因的说明。

钩子手法分类

分析器可识别以下钩子类型：pattern-interrupt（打断预期模式）、question（以问题开场）、bold-claim（抛出惊人论断）、story-tease（暗示叙事）、visual-shock（视觉冲击开场）、curiosity-gap（制造信息缺口）、direct-address（面向特定人群说话）、controversial-take（争议性观点）、relatable-pain（直击常见痛点）、transformation-preview（展示前后变化）。

内容格式分类

识别的内容格式包括：problem-solution（提出问题并给出解法）、listicle（编号式清单）、story（叙事弧线）、tutorial（分步教学）、before-after（前后对比揭示）、day-in-life（生活方式内容）、reaction（对其他内容作出反应）、hot-take（观点表达）、tool-demo（产品/工具展示）。

前置条件

需要配置 GEMINI_API_KEY 环境变量。
需要安装 google-genai 和 requests Python 包。

使用方式

通过脚本命令行运行：

python3 .claude/skills/video-content-analyzer/scripts/analyze_videos.py \
  --input outliers.json \
  --output video-analysis.json \
  --platform instagram \
  --max-videos 5

参数

参数	说明
`--input`, `-i`	包含 outlier 帖子的输入 JSON 文件（必填）
`--output`, `-o`	输出结果的 JSON 文件（必填）
`--platform`, `-p`	平台：instagram、tiktok 或 youtube（默认：instagram）
`--max-videos`, `-n`	最多分析的视频数量（默认：5）

输入格式

接受来自平台研究技能的 outlier JSON，兼容两种格式：

直接列表：[{post1}, {post2}, ...]
包裹格式：{"outliers": [{post1}, {post2}, ...]}

脚本会自动映射各平台特有的字段：

平台	视频 URL 字段	文案字段	用户名字段
Instagram	videoUrl	caption	ownerUsername
TikTok	videoUrl、video_url、webVideoUrl	text、desc	authorUsername
YouTube	videoUrl、url	title	channelTitle

TikTok 注意事项：Apify TikTok Scraper 返回的是 webVideoUrl（TikTok 页面 URL），而非直接视频下载地址。Gemini 会尝试基于该页面 URL 进行分析。

输出格式

返回 JSON 数组，包含每条视频的分析结果，结构示例：

[
  {
    "post_id": "ABC123",
    "username": "creator",
    "url": "https://...",
    "platform": "instagram",
    "likes": 50000,
    "comments": 1200,
    "views": 500000,
    "analysis": {
      "hook": {
        "technique": "pattern-interrupt",
        "opening_line": "Stop scrolling if you...",
        "attention_grab": "Creates urgency and targets specific audience",
        "replicable_formula": "Stop scrolling if you [pain point]"
      },
      "content_structure": {
        "format": "problem-solution",
        "sections": [...],
        "pacing": "fast",
        "retention_techniques": ["pattern interrupts", "text overlays"]
      },
      "delivery_style": {
        "speaking": "direct-to-camera",
        "energy": "high-energy",
        "text_overlays": true,
        "visual_style": "quick cuts with b-roll"
      },
      "cta_strategy": {
        "type": "follow",
        "cta_text": "Follow for more tips",
        "placement": "end"
      },
      "why_it_works": "..."
    }
  }
]

适用场景

适合需要批量分析短视频内容、提炼爆款钩子与内容结构、总结可复制创作模式的场景，通常与平台研究技能配合使用，以其输出的 outlier JSON 作为输入。

限制

关于可用平台范围之外的更多限制、计费方式与价格等信息，资料中暂未提供。