AutoTube 担当者マニュアル

最終更新: 2026年5月13日 / 対象: 一般担当者

第1章: AutoTubeとは

システムの目的

AutoTubeは、YouTubeチャンネル運営代行を効率化するためのツールです。以下の業務をAIとデータ分析で支援します。

• 動画企画の立案 -- AIを使ったキーワードリサーチ、競合分析、ネタ候補の自動生成
• 台本の自動生成 -- タイトル、概要文、台本をAIが一括作成
• パフォーマンス分析 -- CTR（クリック率）、視聴維持率、エンゲージメント率などの指標を自動集計
• PDCAサイクル -- 投稿スケジュール管理、KPI追跡、振り返り分析を1つの画面で完結

3層アーキテクチャ（担当者が知るべきこと）

AutoTubeは3つの層に分かれて動作しています。担当者が直接操作するのは第3層（作業PC）のみです。

担当者の役割

担当者は、割り当てられたチャンネルについて以下の業務を行います。

1. ネタ出し -- ネタスタジオでキーワードリサーチと競合分析を行い、動画の企画候補を作成する
2. 台本作成 -- パイプラインでAIに台本を生成させ、推敲エディタで仕上げる
3. 投稿管理 -- PDCAダッシュボードのカレンダーで投稿スケジュールを管理する
4. 分析・改善 -- KPIや動画分析の結果をもとに、次の企画に改善点を反映する
5. 日次チェック -- チェックリストで毎日のルーティンタスクを完了させる

第2章: パイプライン（動画制作フロー）

★ 初期セットアップ（Gemini APIキー — 各担当者で必ず実施）

1. Google AI Studioにアクセス — https://aistudio.google.com/apikey を開きます（Googleアカウントでログイン）
2. APIキーを作成 — 「Create API Key」（APIキーを作成）をクリック。プロジェクトは任意（デフォルトでOK）
3. キーをコピー — 生成されたキー（AIza...で始まる文字列）をコピーします
4. パイプラインで設定 — パイプラインのTOP画面 → チャンネル選択 → 「チャンネル設定」ボタン → 「API接続設定」セクション → Gemini API Key欄に貼り付けて保存

パイプラインとは

パイプラインは、動画の企画から台本完成までをステージごとに進める制作フローです。各ステージでAIが自動的に文章を生成し、最終的に完成稿が出力されます。

各ステージの目的と操作方法

A0: テーマ入力

動画のテーマ（キーワード）を入力するステージです。ネタスタジオで採用したネタをここに入力するか、自分で新しいテーマを入力します。公開予定日もここで設定します（必須）。

A1: リサーチ

入力されたテーマについて、AIが関連情報をリサーチします。2段階で実行されます。

1. 予備調査（Flash） -- 高速モデルで大まかな調査を行う
2. 本調査（Pro） -- 予備調査の結果をもとに、詳細なリサーチを行う

サムネイル構造解析の結果がある場合、パターン情報が自動で注入されます。

A2: 構成案

リサーチ結果をもとに、動画の構成（概要文と本文の骨子）をAIが生成します。出力は「タイトル」「概要文」「本文」の3点です。

A3: タイトル案

構成案をもとに、クリック率を意識したタイトル候補をAIが生成します。

A4: 台本

構成案とタイトルを踏まえ、AIが完全な台本を生成します。出力は「タイトル」「概要文」「本文」の3点で、脚本のト書きは含まれません。

A5: 推敲

台本を推敲エディタで編集・仕上げるステージです。詳細は「推敲エディタの使い方」を参照してください。

B: サムネイル

サムネイル制作の参考情報を表示します。タイトルや構成に合わせたサムネイルを作成してください。

C: 投稿準備

完成した台本とサムネイルを確認し、投稿に必要な情報（タイトル、概要文、タグなど）を最終確認するステージです。

AIモデル選択

各ステージでは、使用するAIモデルを選択できます。

一括実行と個別実行

一括実行

A0にテーマを入力した状態で「一括実行」ボタンを押すと、A1からA4まで自動的に順番に実行されます。A5（推敲）の手前で自動停止するので、推敲は手動で行ってください。

個別実行

各ステージの「実行」ボタンを個別に押して、1ステージずつ進めることもできます。前のステージの結果を確認してから次に進みたい場合に使います。

推敲エディタの使い方

A5ステージで「推敲エディタを開く」をクリックすると、左右分割の推敲画面が開きます。

画面構成

• 左ペイン -- AI生成の原稿（編集可能）
• 右ペイン -- AI再考の結果が表示される領域

AI再考機能

台本の一部を選択して「AI再考」を実行すると、3つのモデル（Gemini/Claude/GPT）が同時に代替案を生成します。

1. 修正したい箇所をマウスで選択する
2. 場面指定（5種類から選択）と修正の方向性を指定する
3. 「AI再考」ボタンを押す
4. 3つのモデルの提案が右ペインに表示される
5. 採用したい提案の「採用」ボタンを押すと、左ペインの原稿に反映される

完成稿の提出

推敲が完了したら、「完成稿を提出」ボタンを押します。ト書き変換（ナレーション用のフォーマットに変換）も選択できます。

第3章: PDCAダッシュボード

PDCAダッシュボードは、チャンネルのパフォーマンスを確認し、改善サイクルを回すための画面です。画面上部のタブで各機能を切り替えます。

概況タブ

チャンネル全体のパフォーマンスを一目で把握できるタブです。

KPIカード

画面上部に7つのKPIカードが表示されます。各カードには現在値と前期比の変化率が表示されます。

期間別比較

画面上部のドロップダウンで期間（7日/30日/90日）を切り替えると、各KPIの値が期間に応じて変化します。前期間との比較で上昇/下降が矢印で表示されます。

月別推移グラフ

主要KPIの月別推移が折れ線グラフで表示されます。トレンドの把握に活用してください。

日次トレンド

直近の日次データがグラフで表示されます。投稿直後のパフォーマンス変動を確認するのに便利です。

近況タブ

自社チャンネルとライバルチャンネルの最近の動向を比較するタブです。

動画一覧

最近公開された動画がサムネイル付きの一覧で表示されます。各動画には以下の情報が付いています。

• タイトル、公開日、視聴回数
• CTR、視聴維持率、エンゲージメント率
• 総合評価スコア（A/B/C/Dの4段階）

評価スコアの意味

レーダーチャート

動画を選択すると、CTR・維持率・エンゲージメント率などの指標をレーダーチャートで視覚的に比較できます。

チャンネルフィルタ

画面上部のフィルタで、自社チャンネルのみ表示するか、ライバルチャンネルも含めて表示するかを切り替えられます。

チェックリストタブ

毎日のルーティンタスクを管理するタブです。

• タスクのチェックボックスをクリックして完了にする
• 完了すると自動的にAIが確認を行い、タスクに問題がないか判定する
• 日付が変わるとチェックリストがリセットされる

カレンダータブ

投稿スケジュールをカレンダー形式で管理するタブです。

• 日付をクリックして新しい投稿予定を追加する
• 投稿予定には「チャンネル名」「動画タイトル」「ステータス」が表示される
• 同一チャンネルの投稿は中3日以上空ける制限があります（YouTubeのアルゴリズム対策）
• 投稿日の18時にアラートが表示されます

動画分析タブ

自社チャンネルの動画を詳細に分析するタブです。

分析手順

分析結果の見方

Gemini分析の結果には以下が含まれます。

• 強み -- その動画で特に良かった点
• 弱み -- 改善が必要な点
• 改善提案 -- 次の動画に活かせる具体的なアドバイス
• 競合との比較 -- 同ジャンルの他チャンネルとの相対的な位置づけ

ネタ出しタブ

パイプラインやネタスタジオで生成されたネタ候補を管理するタブです。

• ネタスタジオで作成した企画が自動的にこのタブに反映されます
• テーマ別のフィルタでネタを絞り込めます
• 各ネタに対して「採用」「不採用」「保留」のステータスを設定できます
• 採用したネタはパイプラインのA0に直接取り込めます

KPIタブ

進捗・KPIページへのリンクが表示されます。クリックすると進捗・KPIページ（別画面）に遷移します。詳細は第4章を参照してください。

第4章: 進捗・KPIページ

進捗・KPIページは、チャンネルのパフォーマンスを多角的に分析するための専用ページです。ナビバーの「進捗・KPI」からアクセスできます。

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

ページ上部に、主要KPIの目標達成率がレーダーチャートで表示されます。各軸は目標値に対する達成率（%）を示しており、チャートが大きいほど目標に近づいていることを意味します。

3大ランキング

以下の3種類のランキングが表示されます。

最強/最弱動画

最もパフォーマンスが良かった動画（最強）と、改善が必要な動画（最弱）がそれぞれ表示されます。

• CTR -- サムネイルのクリック率。高いほどサムネイルやタイトルが魅力的であることを示す
• 視聴維持率 -- 動画をどこまで見続けてもらえたかの割合。高いほど内容が飽きられていない
• エンゲージメント率 -- (高評価数 + コメント数) / 視聴回数 x 100。高いほど視聴者の反応が良い

AI分析の実行方法

最強/最弱動画のカードをクリックすると、Gemini AIによる詳細分析が実行されます。

KPI基準値テーブル（尺別）

動画の尺（長さ）ごとのKPI基準値が表形式で表示されます。自分の動画の数値をこの基準値と比較することで、どの指標に改善余地があるか判断できます。

目標と達成状況

チャンネルごとに設定された目標値と現在の達成状況が一覧表示されます。達成率が100%に近づくよう、毎月の振り返りで目標値を見直してください。

第5章: ネタスタジオ

ネタスタジオの目的

ネタスタジオは、AIを使ってYouTube動画の企画候補を効率的に生成するための専用ツールです。キーワードリサーチから競合分析、ネタ候補の自動生成までを一貫して行えます。

パイプラインとは独立した画面で、じっくりとネタ出しに集中できます。

キーワードリサーチ

チャンネルのジャンルに関連するキーワードをAIが調査し、視聴者が検索しそうなテーマ候補を提案します。

競合分析

ライバルチャンネルの最近の動画を分析し、どんなテーマが伸びているかをAIが解析します。

• ライバルチャンネルの動画一覧を表示
• 各動画のパフォーマンス（視聴回数、CTR等）を確認
• AIが「なぜその動画が伸びたか」を分析
• 自社チャンネルに転用できるポイントを提案

ネタ候補の生成と管理

キーワードリサーチと競合分析の結果をもとに、AIが具体的な動画企画（ネタ）を複数提案します。

• 各ネタには「タイトル案」「概要」「想定ターゲット」が含まれる
• 気に入ったネタは「採用」にして保存
• 今は使わないが将来使えそうなネタは「保留」に
• 使わないネタは「不採用」にして非表示に

PDCAへの自動反映

ネタスタジオで「採用」にしたネタは、PDCAダッシュボードの「ネタ出し」タブに自動的に反映されます。PDCAのネタ出しタブからパイプラインに取り込む（A0テーマに設定する）こともできます。

この流れにより、ネタ出しから台本完成までがシームレスにつながります。

第6章: 日常の運用フロー

毎日やること

• チェックリスト確認 -- PDCAダッシュボードのチェックリストタブを開き、当日のタスクを確認して完了させる
• コメント返信 -- 担当チャンネルの動画に付いたコメントに返信する（YouTube Studio経由、VPN PCで作業）
• 投稿予定の確認 -- カレンダータブで今日・明日の投稿予定を確認する
• 投稿作業 -- 投稿予定がある場合は、Cステージの情報をもとに投稿する（VPN PCで作業）

毎週やること

• 近況タブの確認 -- PDCAダッシュボードの近況タブで、自社とライバルの週次パフォーマンスを比較する
• 競合分析 -- ネタスタジオの競合分析で、ライバルの新着動画をチェックする
• ネタ出し -- キーワードリサーチとネタ候補生成を行い、来週以降の企画をストックする
• 台本作成 -- 採用したネタをパイプラインに投入し、台本を作成する

毎月やること

• KPI振り返り -- 進捗・KPIページで月間のパフォーマンスを確認する
• 最強/最弱動画の分析 -- AI分析を実行し、成功/失敗の要因を把握する
• 目標見直し -- 達成状況に応じて来月の目標を調整する
• 概況タブの月別推移確認 -- 長期的なトレンドを確認し、改善施策の効果を検証する

第7章: トラブルシューティング

データが表示されない場合

サーバーに接続できない場合

Gemini APIエラーの場合

第8章: OAuth認証の設定と再設定

OAuthとは何か

YouTube Analytics API（CTR・維持率・収益等の非公開データ）にアクセスするために、Googleアカウントの許可が必要です。この許可プロセスを「OAuth認証」と呼びます。

OAuth認証が完了していないチャンネルは、PDCAダッシュボードや進捗KPIでCTR・維持率が「—」と表示されます。

OAuth状態の確認方法

PDCAダッシュボードの概況タブでCTR・維持率が「—」と表示されている場合、OAuthが未設定または無効です。責任者に確認すると、以下のいずれかの状態が伝えられます。

事前準備（責任者と担当者で確認）

初回設定手順（VPN PCで実行）

1. VPN PCに接続 — 対象チャンネル専用のVPN PCにリモートデスクトップで接続します
2. コマンドプロンプトを開く — Windowsキー → 「cmd」と入力 → Enter
3. フォルダに移動 — cd C:\autotube を入力してEnter
4. 認証コマンドを実行 — python collector.py --auth を入力してEnter。ブラウザが自動的に開きます
5. Googleアカウントでログイン — 対象チャンネルのYouTube Studioにアクセスできるアカウントでログイン
6. 権限を許可 — 「YouTubeアカウントの管理」「YouTube Analyticsのデータの閲覧」「YouTube Analyticsの収益データの閲覧」を全て許可
7. 完了確認 — コマンドプロンプトに「認証成功」と表示されたら完了。翌朝4時からCTR等が自動取得されます

再設定手順（invalid_token の場合）

トークンが期限切れまたは無効になっています。上記の「初回設定手順」と全く同じ手順で再認証してください。

認証後の確認方法

1. 翌朝4時以降に、PDCAダッシュボード → 概況タブでCTR・維持率の数値が表示されることを確認
2. 進捗・KPIページで、KPI基準値テーブルの「自社現在値」にCTR・維持率が表示されることを確認
3. それでも「—」のままの場合は責任者に報告してください

第9章: 作業別指南書

各種メンテナンス作業の詳細手順をまとめています。作業が発生した際に該当する指南書を参照してください。

指南書一覧

GitHub PAT更新手順

STEP 1: GitHubにログイン

ブラウザで https://github.com/login を開き、AutoTubeリポジトリのオーナーアカウントでログインします。

STEP 2: 新しいPATを発行

1. ログインした状態で https://github.com/settings/tokens?type=beta を開きます
2. 「Generate new token」 をクリック
3. 以下を入力します：

   Token name	autotube-server-YYYY-MM（今月の年月）
   Expiration	90 days を選択
   Repository access	Only select repositories → autotube を選択

4. Permissions で Contents: Read and write にチェック
5. ページ下部の 「Generate token」 をクリック
6. 表示されたトークン（github_pat_で始まる文字列）をコピー
   ⚠️ この画面を閉じるとトークンは二度と表示されません！

STEP 3: サーバーにPATを設定

PowerShellを開いて、以下をコピー＆ペーストして実行します。
★「ここにPATを貼り付け」の部分だけ、STEP 2でコピーしたトークンに置き換えてください。

$pat = "ここにPATを貼り付け"
$body = @{github_pat=$pat; expires_at="2026-08-05"} | ConvertTo-Json
$headers = @{Authorization="Bearer b34b4c82-6d7c-469d-ab33-c1ff1abc78e7"; "Content-Type"="application/json"}
Invoke-RestMethod -Uri "http://143.189.213.57/api/rotate_pat" -Method POST -Headers $headers -Body $body

結果に ok: True と表示されれば成功です。

STEP 4: デプロイ実行

$headers = @{Authorization="Bearer b34b4c82-6d7c-469d-ab33-c1ff1abc78e7"; "Content-Type"="application/json"}
Invoke-RestMethod -Uri "http://143.189.213.57/api/deploy" -Method POST -Headers $headers -Body '{"force_restart":true}'

git pull: OK と表示されれば完了です。

VPN PC OAuth再認証手順

STEP 1: VPN PCにリモート接続

リモートデスクトップ等でVPN PCに接続します。VPN接続済みの状態で作業してください。

STEP 2: collectorサービスを一時停止

PowerShellを管理者権限で開いて実行：

C:\autotube\nssm.exe stop AutoTubeCollector

STEP 3: client_secrets.json の確認

Test-Path C:\autotube\client_secrets.json

True → STEP 4へ。

False → 以下の手順でclient_secrets.jsonを取得してください：

1. ブラウザで https://console.cloud.google.com/apis/credentials を開く
2. YouTubeチャンネルのGoogleアカウントでログイン
3. 上部のプロジェクト選択で、AutoTube用のプロジェクトを選択
4. 「OAuth 2.0 クライアント ID」の一覧から該当する行を見つける
5. 行の右端にあるダウンロードボタン（↓アイコン）をクリック
6. ダウンロードしたファイルを C:\autotube\ フォルダにコピー
7. ファイル名を client_secrets.json に変更

STEP 4: OAuth認証を実行

cd C:\autotube
python collector.py --auth

1. ブラウザが自動で開きます
2. YouTubeチャンネルのGoogleアカウントでログイン
3. 「AutoTubeがアクセスをリクエストしています」→ 「許可」をクリック
4. 「このウィンドウは閉じて構いません」と表示 → 閉じてOK
5. PowerShellに [OAuth] 認証成功。token.json を保存しました。 と表示されれば成功

STEP 5: token.json の確認

認証が成功したか確認します。PowerShellで以下を実行：

# token.jsonが生成されたか確認
Test-Path C:utotube	oken.json

# ファイルサイズ確認（500バイト以上なら成功）
(Get-Item C:utotube	oken.json).Length

• True かつ 500バイト以上 → 成功。STEP 6へ
• False → STEP 4をやり直してください

STEP 6: テスト収集

python collector.py --no-update

ログに以下が表示されればOAuth認証が有効です：

• Analytics収集: ＜チャンネル名＞
• 日別パフォーマンス: ○○日分
• 維持率カーブ取得: ○○本

STEP 7: サービス再開

C:\autotube\nssm.exe start AutoTubeCollector

STEP 8: サーバーで確認

以下のURLを開いて、CTR・維持率・IMPが表示されることを確認：

http://143.189.213.57/api/live/pdca_dashboard_v2.html?token=137cbc70-3171-11f1-a65f-9c6b003587a2