/analytics

Use when YouTube Analytics の収集・分析・レポート表示を一括実行または一段だけ実行するとき。フラグなしは収集→分析→表示を状態判定付きで進める。公開済み動画の失速分析は --flop と video_id / collection / --since 、登録者・再生回数など YouTube 統計の表示は --status を使う。「Analytics 一括実行」「データ更新」「パフォーマンス分析」「レポート見せて」「伸びなかった」「登録者数は？」で発動。一段だけは排他的な --collect / --analyze / --report / --flop / --status を使う。制作進捗は /wf-status

何ができるか

YouTube Analytics のデータ収集から分析、レポート表示までを、成果物の鮮度を見ながら進めるスキルです。フラグなしなら収集 → 分析 → 表示を順番に判定し、完了済みの工程は再実行しません。日々の数値確認だけでなく、伸びなかった公開済み動画の原因整理にも使えます。

mode	すること	主な成果物・表示
`--collect`	YouTube の統計を収集	`data/analytics_data_*.json`
`--analyze`	収集データから傾向・勝ちパターンを分析	`reports/analysis_*.json` / `.html`、`data/insights.jsonl`
`--report`	検証済みの最新分析レポートを表示	最新の分析 JSON / HTML
`--flop`	公開済み動画の失速要因を検証	collection 内の `postmortem.md`、insights
`--status`	登録者数・再生回数・collection 一覧を表示	チャット内のチャンネル統計

データ更新からレポート確認までまとめて進めたいとき

/analytics

collect → analyze → report を状態判定つきで実行します。鮮度内の収集・分析結果は再利用するため、定期的な振り返りにも、途中失敗後の再開にも向いています。

一工程だけ実行したいとき

/analytics --collect
/analytics --analyze
/analytics --report

--collect は通常の統計収集、--analyze は収集済みデータの比較・傾向分析、--report は最新レポートの表示だけを行います。mode は排他的なので、一度に指定するのは 1 つだけです。

伸びなかった動画を振り返りたいとき

/analytics --flop <video_id>
/analytics --flop <collection>
/analytics --flop --since 30

動画 ID または collection を指定して、症状の定量化、仮説の検証、学びの記録まで進めます。対象を省略した場合、--since <N> で公開後 N 日以内の動画に候補を絞れます。改善策そのものは実行せず、次に試す内容を postmortem と insights に残します。

チャンネルの現在値をすぐ見たいとき

/analytics --status

登録者数、総再生回数、公開動画数と collection 一覧を表示します。制作工程の進捗ではなく YouTube 上の統計を確認したいときに使います。

つまずいたら

config を読めず止まる — 新規チャンネルは /setup --channel、既存チャンネルの取り込みは /setup --import を先に実行してください
--analyze が入力不足で止まる — 先に /analytics --collect で最新データを収集してください
--report で表示できるレポートがない — /analytics --analyze を実行し、同日付の検証済み JSON / HTML ペアを作ってください
--flop で collection を特定できない — collection 名を明示するか、対象動画を記録した upload_tracking.json を整備してください
複数の mode を指定して止まる — --collect などの mode は 1 回に 1 つだけ指定してください

リファレンス

発動フレーズ

Analytics 一括実行
データ更新
パフォーマンス分析
レポート見せて
伸びなかった
登録者数は？

前後工程

前工程: /setup
後工程: /wf-new
委譲先: なし

成果物

書き込む: data/analytics_data_*.json, reports/analysis_*.json, reports/analysis_*.html, data/insights.jsonl
読み込む: config/skills/analytics.yaml, config/channel/*.json, auth/token.json, collections/<id>/workflow-state.json

想定 API call 数

--report はローカル成果物だけを読む。--analyze は VPD ranking のため YouTube Data API を 1 回の走査で使う。フラグなしまたは --collect で収集が必要な場合は collect 分も加えて次の call 数を見込む。--status は単独実行し、call 数は references/status.md を正とする。

API	call 数 / 実行	変動要因
YouTube Data API v3	約 3 + ceil(動画数/50) units	チャンネルの動画数
YouTube Data API v3（analyze VPD）	約 3 + 2 × ceil(動画数/50) units	uploads 全ページ + statistics 50 件 batch。鮮度内 schema v3 レポートは再利用
YouTube Analytics API	standard で約 10 + 直近動画数 call	対象期間、動画数
YouTube Analytics API（full 追加分）	country / retention で最大 +11 call	full 指定時のみ
YouTube Reporting API	reporting mode 時のみ数 call	job と生成済み report の状態

鮮度内の既存データは再利用する。standard 収集の実行コマンドは uv run yt-analytics。その他の mode と詳細な上限は references/collect.md を正とする。

上限 / 承認: freshness_minutes 内の成果物があれば収集を skip し、Reporting job 作成前は dry-run で状態を確認する