video-performance-analyzer

動画パフォーマンス分析ツール

このスキルでできること

ショート動画（MP4 ファイルまたは YouTube URL）を入力すると、次の 3 つを返します。

1. 全文トランスクリプト — 発話、画面上のテキスト、音声の合図をすべてタイムスタンプ付きで記録します
2. パフォーマンス分析 — 実証済みの成長フレームワークに照らし合わせて、動画がうまく機能する理由を分析します
3. 再利用プレイブック — 動画から導き出した具体的なコンテンツ案を提示します

---

セットアップ

分析スクリプトでは、Google の Gemini API（トランスクリプトと分析を生成するモデル）を使用します。

API キー： リポジトリのルートにある .env から読み込みます — GEMINI_API_KEY

依存関係のインストール（初回のみ）：

pip install google-genai --break-system-packages

スクリプトの場所： <skill-directory>/scripts/analyze_video.py

---

入力形式

形式	渡し方	備考
ローカル MP4 ファイル	引数としてファイルパスを指定	無料プランでは最大 2GB、有料プランでは最大 20GB
YouTube URL	引数として URL を指定	公開動画のみ
TikTok / Instagram	最初にダウンロードし、その後 MP4 のパスを渡す	ブラウザー拡張機能または yt-dlp を使用

---

分析の実行

クイック実行

python <skill-directory>/scripts/analyze_video.py /path/to/video.mp4

YouTube URL

python <skill-directory>/scripts/analyze_video.py "https://www.youtube.com/watch?v=VIDEO_ID"

出力をファイルに保存

python <skill-directory>/scripts/analyze_video.py /path/to/video.mp4 --output /path/to/output.md

スクリプトは構造化された Markdown を標準出力に表示します。必要に応じてパイプまたはリダイレクトしてください。

---

分析ワークフロー

ステップ 1：スクリプトを実行する

動画のパスを指定して analyze_video.py を実行します。スクリプトは次の処理を行います。

• 動画を Gemini Files API にアップロードします（または YouTube URL を直接渡します）
• 処理が終わるまで待機します（通常 10～30 秒）
• 分析プロンプトを gemini-3-flash-preview に送信します
• 構造化された未加工の出力を返します

ステップ 2：成長フレームワークに照らし合わせる

スクリプトの実行後、次の成長要素に基づいて出力を解釈します。

フック —「フックは契約」

• フックによって、視聴者は自分が当事者だと感じたり、名指しされたと感じたり、強い好奇心を抱いたりしましたか？
• 5 つのフック手法のいずれかを使っていますか？（矛盾、意外な文脈と組み合わせた具体的な数字、直接的な非難、視聴者が考えていたことの代弁、ばかげた視点の転換）
• 視聴者の状況について語っていますか。それともクリエイターの実績についてですか？
• 注目すべきフレーミングの工夫：認識される重要性を高める、意図的な言葉の選択

構成 — 段階的な興味の喚起

• 各タイムスタンプの展開を対応づけ、展開ごとに緊張感が高まっているかを評価します
• 「だから／しかし」の連鎖に注目します。各展開が次の展開を引き起こしていますか。それとも、ただ続いているだけですか？
• 情報の空白がどこで生まれ、どこで埋まるかを特定します
• 直前の展開から予測できる箇所があれば、指摘します

信頼性 — 具体性のシグナル

• 具体的な数字、実名、正確な日付、金額を数えます
• 主張と同時に領収書や情報源を映像で示す「証拠提示」の場面があれば、記録します
• 一般的な主張は弱く、名前と数字を含む主張は強いものです。

フレーミング — 視聴者を第一に

• 動画はクリエイターの実績についてですか。それとも視聴者の状況についてですか？
• パフォーマンスの高い動画はどれも、その価値を視聴者が得るものを軸に見せています
• 個人的な節目を軸にしたフレーミングは、既存の視聴者には効果がありますが、それ以外には届きません

視聴維持 — 視覚的なパターンの中断

• 映像はどのくらいの頻度で切り替わりますか？目標は 5～10 秒ごとです
• 背景やオーバーレイが効果的であるほど、視聴維持率が上がり、プラットフォームが新たな視聴者に動画を届けます
• 注意をリセットするトランジション、オーバーレイ、テキストカード、B ロールへの切り替えがあれば、記録します

CTA — ループを閉じるか、開くか

• 最後に視聴者の疑問を解決していますか。それとも、未解決のまま残していますか？
• 最高の CTA は、フォローすることが当然の次の行動になる状況を作ります（暗示的な CTA）
• 弱い CTA：「何か学びがあったら、いいねとフォローをお願いします」「コメントで教えてください」
• 強い CTA：「数時間後にどうなるか見てみましょう」（先へ進みたくなる流れを作ります）

ステップ 3：再利用のアイデアを生成する

分析に基づき、単独コンテンツとして活用できる切り口をすべて特定します。アイデアごとに、以下をまとめます。

• 最適な形式（ショート動画、LinkedIn 投稿、X スレッド、ニュースレターのセクション）
• フック／バナーの内容
• 該当するコンテンツの柱／テーマ（設定している場合）
• ファネルの段階（TOFU／MOFU／BOFU）

再利用の元ネタとして探すポイント：

• 動画内で最も強い主張 → 単独の大胆な意見として投稿
• 物語に暗示されている「前／後」や「X 対 Y」 → 比較形式
• 紹介されている手順ごとのワークフロー → リスト形式の記事またはツール紹介動画
• 感情の核心（恐怖、驚き、怒り、安堵） → 個人的な切り口の台本
• 数字や統計データ → データ重視のショート動画
• 逆張りの切り口（あれば） → X スレッドまたはニュースレターのフック

ステップ 4：（任意）コンテンツカレンダーに追加する

Notion をコンテンツカレンダーとして使用している場合は、分析後に再利用のアイデアを追加できます。

プロジェクト設定で Notion データソース ID を設定します。

data_source_id: <your-notion-database-id>

再利用コンテンツのデフォルトフィールド：

• Status：Backlog
• Platform：形式との適合性に基づく
• Content Format：台本の場合は ["Video"]、投稿の場合は ["Text"]
• Content Type：切り口に基づく
• Funnel Stage：TOFU（再利用コンテンツの多くは認知段階向け）
• Re-purpose?：Yes

---

出力形式

以下の順番で結果を提示します。

1. 全文の書き起こし

タイムスタンプ付きの逐語的な書き起こしです。画面上のテキストオーバーレイも、インラインで記載します。

2. 映像と音声の分析

• 形式（トーキングヘッド／ナレーション／B ロール／画面録画）
• 背景／セットのデザイン品質
• 音楽／音声のトーン
• 映像の切り替え頻度（1 分あたりのパターン中断回数）

3. パフォーマンス分析

各項目を評価します（強い／普通／弱い）。

項目	評価	メモ
フックの強さ
段階的な興味の高まり
具体性／信頼性
読者を第一に考えた構成
視覚的なパターン中断
CTA の質

続けて、この動画のパフォーマンスが高い理由を 3～5 個、一般論ではなく具体的な仕組みとして箇条書きにします。

4. 再利用の実践ガイド

アイデアごとに、以下を記載します。

**[Format] — [Working title / angle]**
- Hook: ...
- Format: ...
- Content pillar / theme: ... (if you use them)
- Funnel stage: ...
- Why it'll work: 1 sentence

動画 1 本につき、再利用のアイデアを 4～8 個挙げてください。少なくとも 2 個は、すぐに台本にできるものにします。

5. 取り入れるべきポイント

この動画から直接取り入れるべき、具体的で実行可能なテクニックを 3～5 個挙げます。一般論ではなく、各テクニックが動画のどの場面で使われているかを示します。

---

このスキルで行わないこと

• TikTok または Instagram の動画をダウンロードする（手動でダウンロードしてから、パスを渡してください）
• 投稿または公開を行う（分析とアイデア出しのみ）
• 非公開または限定公開の YouTube 動画にアクセスする
• クリエイティブな判断に取って代わる（分析で効果的な要素を明らかにし、何を取り入れるかはあなた自身のセンスで選びます）

---

モデル選択に関する注意事項

• 書き起こし＋分析： gemini-3-flash-preview — 動画の理解に最適で、3～5 分のショート動画も簡単に処理できます
• 埋め込み（将来）： gemini-embedding-2-preview — パフォーマンスの高い動画ライブラリと意味的に比較するために使用します。スクリプトにはまだ実装されていませんが、アーキテクチャの準備はできています。
• 無料枠の制限： YouTube 動画は 1 日 8 時間までです。アップロードしたファイルには制限がありません（有料枠）。ショート動画は制限内で十分に処理できます。