Video Content Analyzer

短編動画を Gemini AI で分析し、フックス、コンテンツ構造、デリバリースタイル、CTA 戦略を抽出します。

前提条件

• 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	アウトライア投稿を含む入力 JSON ファイル (必須)
--output, -o	結果の出力 JSON ファイル (必須)
--platform, -p	プラットフォーム: instagram、tiktok、youtube (デフォルト: instagram)
--max-videos, -n	分析する最大動画数 (デフォルト: 5)

入力形式

プラットフォーム固有のリサーチスキルからアウトライア 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 は直接動画ダウンロード URL ではなく 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": "..."
    }
  }
]

フック テクニック

アナライザーは以下のフック タイプを識別します:

• pattern-interrupt - 予想されたパターンを破壊
• question - 魅力的な質問で開始
• bold-claim - 驚くべき主張をする
• story-tease - compelling なストーリーへの示唆
• 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 - 製品/ツールのデモ