AutoTube 機能ガイド

ステージ一覧

ステージ	内容	AIモデル
A0 テーマ入力	動画テーマ・キーワード・公開予定日を入力	—
A1 リサーチ	Geminiがウェブ検索で競合・トレンド・検索ボリュームを調査	Flash → Pro 2段階
A2 構成案	タイトル・概要文・構成案を生成	Pro
A3 台本	ゴースト台本/プレゼン台本を生成	Pro
A4 推敲	生成された台本を推敲エディタで修正	3モデル並列
A5 完成稿	最終確認・ト書き変換・提出	—

一括実行

A0〜A4を連続で自動実行し、A5の手前で停止します。完成稿は必ず人間が確認してから提出します。

推敲エディタ

左右分割画面で原稿を確認しながら、AIに部分的な再考を依頼できます。

• 場面指定5種: 冒頭/中盤/終盤/特定場面/全体から選択
• 3モデル同時: Gemini/Claude/OpenAIに同時に再考を依頼し、最も良い案を採用
• 文節数自由: 再考する範囲を文節単位で指定

チャンネル設定

📊 概況タブ

チャンネルの現在のKPIを一覧表示します。

表示項目	データソース	説明
平均再生数	video_snapshots	直近1ヶ月の動画平均再生数
高評価率	video_snapshots	高評価数 ÷ 再生数 × 100
コメント率	video_snapshots	コメント数 ÷ 再生数 × 100
エンゲージ率	video_snapshots	(高評価+コメント) ÷ 再生数 × 100
CTR	analytics_daily OAuth必須	インプレッションクリック率
維持率	analytics_daily OAuth必須	平均視聴維持率

月別推移グラフ: 過去12ヶ月のKPI推移を折れ線グラフで表示。

成否動画AI分析: 直近3ヶ月の成功/失敗動画をGeminiが自動分析し、要因と改善案を提示。

🔥 近況タブ

直近7日間の自社動画のみを一覧表示します（ライバル動画は除外）。

• 動画タイトルをクリック → YouTubeの動画ページに直接移動
• 評価スコア列をクリック → 12項目レーダーチャート+詳細分析モーダル
• 「未評価を分析」ボタン → 未評価動画をGeminiで自動分析
• 全列ソート可能（再生数/高評価/コメント/投稿日/評価）

✅ チェックリストタブ

毎日の作業タスクを自動生成・管理します。

• AIが動画データに基づいて今日やるべきタスクを自動提案
• チャンネル切替・日付跨ぎで自動再生成
• 完了チェック時にAIが確認メッセージを表示

📅 カレンダータブ

投稿スケジュールと期限管理。中3日制限でオーバーワークを防止。

🎬 動画分析タブ

個別動画の詳細分析を実行します。

• 動画を選択して「分析実行」→ Geminiが詳細レポートを生成
• 分析結果はサーバーにキャッシュされ、全ユーザーで共有（API節約）

💡 ネタ出しタブ

ネタスタジオで生成したネタ候補を管理します。

• パイプラインのネタスタジオから自動反映（インポート不要）
• 採用/不採用/メモの管理
• テーマフィルタでキーワード別に絞り込み
• 「詳細」ボタンで全情報をモーダル表示

📈 KPIタブ

進捗・KPIページへのリダイレクトリンクです。

目標達成率レーダーチャート

10項目のKPI目標に対する達成率をレーダーチャートで視覚化。

3大ランキング

全担当者の中での順位を表示。

最強/最弱動画

今月の最も再生数が多い/少ない動画を表示。ショート動画（3分以下）は自動除外されます。

AI分析

動画をクリックするとGeminiが詳細分析を実行。結果はサーバーにキャッシュ。

KPI基準値テーブル

指標	計算式
エンゲージ率	(高評価数 + コメント数) ÷ 再生数 × 100
高評価率	高評価数 ÷ 再生数 × 100
コメント率	コメント数 ÷ 再生数 × 100
CTR	クリック数 ÷ インプレッション × 100 OAuth必須
維持率	平均視聴時間 ÷ 動画長 × 100 OAuth必須

5つのタブ

全自動リサーチ

登録したキーワードを一括でGeminiリサーチ → ネタ候補自動生成 → PDCAに自動反映。

APIキー設定

各担当者が自分のGemini APIキーを設定してください。共有キーはクォータが合算され制限に達しやすくなります。

「接続テスト」ボタンでAPIキーが正常に動作するか確認できます。

9つのタブ

タブ	機能	対象者
概況	全チャンネル横断のKPIサマリー・30日トレンド	責任者
チャンネル一覧	全チャンネルの登録者・平均再生・平均維持率・エンゲージ率	責任者
運営ch管理	チャンネルの追加/編集/削除・OAuth設定・APIキー管理	管理者
担当者	担当者の追加/編集/トークン管理・OAuth状態確認	管理者
KPI比較	チャンネル横断KPIグラフ（登録者/再生数/エンゲージ/アルゴスコア）	責任者
タスク状況	担当者別のタスク完了率・期限超過の管理	責任者
API使用量	Gemini APIのクォータ状況・コスト・プロバイダ別使用量	管理者
VPN PC管理	VPN PCの稼働状況・collector.pyの死活監視・コマンド送信	管理者
設定	Gemini APIキー・サーバー設定・OAuth client_secrets	管理者

担当者管理

各担当者のOAuth状態がカード形式で表示されます。

• OAuth済 — Analytics（CTR/維持率）が自動取得されている
• OAuth未 — VPN PCでの認証が必要
• トークン無効 — 再認証が必要

フローティングバッジ

全ページ（パイプライン/ネタスタジオ/PDCA/管理/進捗）の画面右下に、Gemini APIの日次使用量バッジが常時表示されます。

• 緑 — 使用量80%未満（正常）
• 黄 — 使用量80-93%（注意）
• 赤 — 使用量93%以上（上限間近）

バッジをクリックすると詳細パネルが開き、モデル別内訳（Flash/Pro/Grounding）と現在のRPM（1分あたりリクエスト数）を確認できます。

自動レート制限

モデル種別	最低間隔	RPM上限
Flash（通常）	1.5秒	30回/分
Pro	3秒	15回/分
Grounding付き	5秒	10回/分

リクエストが上限に近づくと自動的に待機し、429エラーを未然に防止します。

リサーチ前の事前チェック

ネタスタジオでリサーチを実行する前に、軽量リクエスト（1トークン）で429を事前検出。クォータ切れの場合はリサーチを開始せず、対処法を表示します。

3層アーキテクチャ

層	場所	許可されるAPI	禁止されるAPI
第1層	VPN PC（チャンネル専用）	YouTube Data API / Analytics API	AI API（Gemini等）
第2層	サーバー	なし（データ保存のみ）	YouTube API（構造的にブロック）
第3層	作業PC	AI API（Gemini/Claude/OpenAI）	YouTube API

構造的ガード（4層ブロック）

サーバー（receiver.py）からYouTube APIドメインへの接続は、以下の4層で物理的にブロックされています。

1. Layer 1: socket.create_connection — 全TCP接続の最下層。迂回不可能。
2. Layer 2: urllib.request.urlopen
3. Layer 3: requests.* — get/post/put/delete/patch/head/options全メソッド
4. Layer 4: http.client.HTTPSConnection

OAuth未認証アラート

担当者ログイン時にOAuth認証が必要なチャンネルがあれば、全画面赤オーバーレイで操作をブロックし、VPN PCでの認証手順をステップバイステップで表示します。管理者には右上に赤バッジで通知（操作はブロックしません）。

チャンネル名マスキング

AIに送信されるプロンプト内のチャンネル名は自動的にマスクIDに置換されます。

• 自社チャンネル → CH_SELF
• 競合チャンネル → RV_01, RV_02, ...

AIのレスポンス受信後に自動復元されます。

収集スケジュール

項目	タイミング	内容
定時収集	毎朝4時（設定変更可）	全チャンネル+競合の再生数/高評価/コメント等
Analytics収集	定時収集と同時	CTR/維持率/収益（OAuth必須）
ハートビート	5分間隔	サーバーとの通信確認+コマンド受信

収集対象

項目	自社チャンネル	競合チャンネル
取得本数	最大500本	最大50本
期間	制限なし（全動画）	直近90日以内
Analytics	✅（OAuth必須）	❌（OAuth権限外）

クォータ保護

• 1日最大5回の収集に制限（YouTube Data API 10,000 units/日）
• 収集失敗時は再試行せず停止し、サーバー反映確認後に再開
• OAuthトークン期限切れ時は自動リフレッシュ

自動復旧

• サーバーが30分ごとにheartbeatを監視し、2時間未受信でforce_collectを自動発行
• 自社動画が0本の場合、heartbeat経由でforce_collectを自動追加
• collector.pyの自動更新: サーバーから最新版を自動ダウンロード・上書き