video-analyzer

name	video-analyzer
description	TikTok/YouTube動画を分析してテンプレート化するスキル。 動画ダウンロード→フレーム抽出→STT→構成分析→テンプレートJSON生成。 競合分析、人気動画の構成学習に使用。 「TikTok分析」「YouTube分析」「動画テンプレート化」「競合動画分析」等で発動。
triggers	["動画を分析","TikTok分析","YouTube動画を分析","競合動画を分析","動画テンプレート化","video-analyzer","動画の構成を学習"]

Video Analyzer

TikTok/YouTube/Instagram動画をダウンロード→分析→テンプレート化する。

対応プラットフォーム

• TikTok — https://www.tiktok.com/@user/video/... / https://vt.tiktok.com/...
• YouTube — https://www.youtube.com/watch?v=... / https://youtu.be/...
• YouTube Shorts — https://youtube.com/shorts/...
• Instagram Reels — https://www.instagram.com/reel/...
• その他 yt-dlp が対応するプラットフォーム

クイックスタート

# TikTok動画を分析
python skills/video-analyzer/scripts/analyze_video.py \
  --url "https://www.tiktok.com/@user/video/123456" \
  --output output/templates/

# YouTube動画を分析
python skills/video-analyzer/scripts/analyze_video.py \
  --url "https://www.youtube.com/watch?v=XXXXX" \
  --output output/templates/

# YouTube Shortsを分析
python skills/video-analyzer/scripts/analyze_video.py \
  --url "https://youtube.com/shorts/XXXXX" \
  --output output/templates/

パイプライン

URL → yt-dlp → 動画ファイル（TikTok/YouTube/Instagram等対応）
  → ffmpeg → フレーム抽出 (1fps)
  → Whisper API → STT (テキスト + タイムスタンプ)
  → Vision AI → フレーム分析 (テロップ位置、デザイン、構図)
  → テンプレート JSON (scenes.json互換)

出力: template.json

{
  "source_url": "https://...",
  "duration": 32.5,
  "resolution": "1080x1920",
  "scenes": [
    {
      "frame_number": 1,
      "timestamp": "0:00-0:03",
      "duration": 3.0,
      "narration": "STTから抽出したテキスト",
      "text_overlay": {
        "text": "画面上のテロップ",
        "position": "center",
        "style": "bold",
        "color": "#FFFFFF",
        "has_stroke": true
      },
       
         
         
         
      
       
       
    
  
   
     
     
     
     
     
     
     
      
  

使い方

1. 単体分析

python analyze_video.py --url "URL"

2. バッチ分析（複数URL）

python analyze_video.py --urls-file urls.txt --output output/templates/

3. Playbook蓄積（別スキル）

分析結果のtemplate.jsonを video-playbook スキルに渡して、タイプ別知見を蓄積：

python skills/video-playbook/scripts/manage_playbook.py --add -t output/templates/template.json

4. テンプレートを使って新動画生成

分析結果のtemplate.jsonをstoryboard-generatorに渡して、自社コンテンツでリメイク：

python generate_storyboard.py --template output/templates/template.json --topic "自社プロダクト名"

依存

• yt-dlp (.bin/yt-dlp)
• ffmpeg (.bin/ffmpeg)
• OpenAI Whisper API (STT)
• Gemini Vision API (フレーム分析)

環境変数

• OPENAI_API_KEY — Whisper STT用
• GEMINI_API_KEY — Vision分析用