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

パラメーター

Arg	説明
--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 - 魅力的なストーリーをほのめかす
• 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 - 製品やツールの紹介