Menü
Use when Analytics分析レポートの表示・閲覧が必要なとき。過去レポートの比較やパフォーマンスレビュー時に使用。「レポート見せて」「過去データ確認」「パフォーマンスレビュー」「前回の分析結果」など、既存レポートの参照・比較が必要な場面で必ず使用すること
Use when Suno UI に投入する音楽プロンプト (Style + Lyrics) を生成したいとき。SunoAI V5 向けの YAML 定義（インストは `tracks_per_collection` で曲数指定の独立 entry 並列、ボーカルは pattern × tracks_per_pattern 設計）から suno-prompts.md / suno-prompts.json を作成する（次工程 `/suno-helper` でブラウザ自動生成 + playlist 一括追加、その後 `/masterup` で DL + マスター化）。プロンプト作成・Style 文・Lyrics テンプレートなど Suno 連続生成の前段で使用すること。Lyria チャンネルでは /lyria を使う
Use when Suno UI に投入する曲をブラウザで連続生成 + playlist 追加したいとき。yt-collection-serve で suno-prompts.json を配信し、suno-helper Chrome 拡張で 1 タブ完結の自動実行（pattern 注入 → Generate → 完了待機 → 次へ → 全件完了で playlist 一括追加）を回す operator 手順。`/suno` でプロンプトが揃った後、または既存 collection の途中再開で使用する
Use when まだコレクションディレクトリが存在せず、新規コレクション制作を立ち上げたいとき。「新しいコレクション始めたい」「制作開始」「新規ワークフロー」など、企画選択からディレクトリ作成・素材準備までを行う初期化フェーズで使用する。既存コレクションの進行は /wf-next
Use when 各コレクションの音楽ムード × サムネイル雰囲気 × タイトル訴求の整合性を監査したいとき。「整合性チェック」「一致してるか確認」「タイトル見直し」「サムネと音楽の一致」「タイトル改善」「CTR改善」など。CTR に最も影響するチェックポイント。方向性見直し時に必ず使用すること
Use when 収集済みのAnalyticsデータを詳細分析し、戦略的改善提案が必要なとき。/analytics-collect でデータ収集後に実行。CTR改善、パフォーマンス分析、戦略検討、データ分析、コレクション比較、投稿の振り返りなど、データに基づく判断が求められる場面で必ず使用すること
Use when YouTube Analyticsデータの収集・最新化が必要なとき。/analytics-analyze 実行前のデータ準備ステップとして使用。ユーザーが「データ更新」「最新の数字」「統計を取得」「分析の準備」と言及したとき、または analytics_system.py の実行が必要な場面で必ず使用すること
| name | analytics-report |
| description | Use when Analytics分析レポートの表示・閲覧が必要なとき。過去レポートの比較やパフォーマンスレビュー時に使用。「レポート見せて」「過去データ確認」「パフォーマンスレビュー」「前回の分析結果」など、既存レポートの参照・比較が必要な場面で必ず使用すること |
reports/ ディレクトリに保存された Analytics 分析レポートを表示、または HTML ビジュアルレポートを生成します。
config/channel/ が存在すること（load_config() でロード可能）。
存在しない場合、ユーザーに確認:
/channel-new を案内/channel-import を案内| 引数 | 説明 |
|---|---|
/analytics-report latest | 最新の分析レポートを表示 |
/analytics-report html | HTML ビジュアルレポートを生成（全履歴データ集約） |
/analytics-report list | 全レポートファイル一覧表示 |
/analytics-report | 引数なし = 最新レポート表示 |
/analytics-report latest / /analytics-report（デフォルト）reports/ ディレクトリから最新のレポートファイルを検出して内容を表示する。
/analytics-report listreports/ ディレクトリ内の全レポートファイルを一覧表示する。
/analytics-report html — ビジュアルレポート生成data/ 配下の 全 analytics スナップショット と benchmark データを集約し、視覚的な HTML レポートを reports/ に生成する。
data/analytics_data_*.json を全件読み込み、時系列順にソートdata/benchmark_*.json の最新ファイルを読み込みconfig/channel/*.json からチャンネル情報を取得channel_analytics.daily_metrics — 日次メトリクス（重複日は最新値優先）channel_analytics.ctr_data — CTR スナップショットvideo_analytics — 動画別メトリクスのスナップショット間推移単一 HTML ファイル（CSS インライン + Chart.js CDN）で以下のセクションを含める:
ヘッダー & KPI カード
日次推移チャート（Chart.js 折れ線グラフ）
動画別パフォーマンス表
動画別 Views 推移（Chart.js 折れ線グラフ）
CTR 推移（Chart.js バーチャート + 折れ線）
競合ベンチマーク比較
分析 & 改善提案
カラーパレット:
- 背景: #0f1419 (ダークネイビー)
- カード背景: #1a2332
- アクセント: #c8a96e (ブランドアクセントカラー)
- テキスト: #e8e6e3
- チャート色: #4ecdc4, #45b7d1, #96ceb4, #ffeaa7, #dfe6e9
- 成功: #00b894
- 警告: #fdcb6e
- 危険: #e17055
フォント: system-ui, -apple-system, sans-serif
レスポンシブ: max-width: 1200px, モバイル対応
reports/{channel_slug}_analytics_YYYYMMDD.html（channel_slug は config/channel/meta.json の channel.short を小文字化したもの、日付は実行日）open reports/{channel_slug}_analytics_YYYYMMDD.html でブラウザ表示Analytics API の ctr_percentage は 整数値（例: 2606 = 実際のパーセントとして解釈が必要）。
impressions と ctr_percentage の関係から実際の CTR% を算出:
click_count ≈ impressions × (ctr_percentage / impressions) ではなく#Shorts を含む動画）。Complete Collection と KPI 構造（CTR / Avg Duration / 視聴維持の意味合い）が異なり同じ表で比較できないため。v5.5.1 で /short 由来の Shorts が増えても本表の集計対象外分析は data/ の収集済みスナップショットを読むため通常は外部 API を呼ばない。再収集が必要なときのみ以下が該当する。
| 状況 | 兆候 | 対処 |
|---|---|---|
| 入力データ不在 | data/ のベンチマーク/Analytics スナップショットが無い | 先に /benchmark・/analytics-collect 等を実行して入力を用意 |
| OAuth 未認証/失効 | auth.oauth_handler の FileNotFoundError（client_secrets.json 不在）/ AuthError / HTTP 403 | 初回認証フローを再実行。403 が続く場合は auth/token.json を削除しスコープを確認のうえ再認証 |
レポート生成後:
→ /analytics-analyze で詳細な戦略分析を実行
→ /collection-ideate でデータに基づくコレクション企画を生成