mcpField
V
video-content-analyzer

video-content-analyzer

github.com/bradautomates营销与增长289843 次安装40 周前更新
代码仓库

关于 video-content-analyzer

video-content-analyzer 是一项使用 Gemini AI 分析短视频内容的技能，适合研究 Instagram、TikTok 和 YouTube 视频的创作者与营销人员。它从视频中识别开场钩子、内容结构、表达方式和行动号召策略，并输出 JSON 分析结果。

主要功能

  1. 01使用 Gemini AI 分析短视频
  2. 02识别开场钩子类型
  3. 03归纳内容结构与形式
  4. 04分析表达方式和行动号召策略
  5. 05输出 JSON 分析结果

适用场景

  1. 01比较不同视频的开场方式
  2. 02梳理短视频的内容结构
  3. 03研究视频中的行动号召策略

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bradautomates/head-of-content --skill video-content-analyzer

安装后在 Claude Code 中输入/video-content-analyzer确认已加载。

附带文件scripts/analyze_videos.py

详细介绍

视频内容分析器

使用 Gemini AI 分析短视频，提取钩子、内容结构、表达风格和 CTA 策略。

前提条件

  • GEMINI_API_KEY 环境变量
  • Python 包 google-genai 和 requests

用法

python3 .claude/skills/video-content-analyzer/scripts/analyze_videos.py \
  --input outliers.json \
  --output video-analysis.json \
  --platform instagram \
  --max-videos 5
参数
参数描述
--input, -i包含异常表现帖子的输入 JSON 文件（必需）
--output, -o用于保存结果的输出 JSON 文件（必需）
--platform, -p平台：instagram、tiktok 或 youtube（默认：instagram）
--max-videos, -n要分析的视频数量上限（默认：5）

输入格式

接受来自特定平台研究技能的异常表现 JSON。支持以下两种格式：

  • 直接列表：[{post1}, {post2}, ...]
  • 包装对象：{"outliers": [{post1}, {post2}, ...]}

脚本会自动映射平台专属字段：

平台视频 URL 字段说明文字用户名
InstagramvideoUrlcaptionownerUsername
TikTokvideoUrl、video_url、webVideoUrltext、descauthorUsername
YouTubevideoUrl、urltitlechannelTitle

TikTok 注意事项：Apify TikTok Scraper 返回的是 webVideoUrl（TikTok 页面 URL），而非可直接下载的视频 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": "..."
    }
  }
]

钩子技巧

分析器可识别以下钩子类型：

  • 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 - 展示产品或工具

评论

支持 Markdown