youtube-automation-agentの使い方——作るのは8体のAI、出すのは人

結論から書きます。

youtube-automation-agent は、動画を自動で「出す」道具ではなく、自動で「作って、人の承認を待つ」道具です。

READMEには、品質・権利・人のレビューの関所を通るまで何も予約されない、と書かれています。承認ゲートは既定でオン。自律モードでもこのゲートは迂回しない、と。

「24時間動くYouTube自動化」という見出しから想像する姿とは、少し違います。この記事では、READMEの記述だけを根拠に、何が自動で、何が人の手に残るかを分けて、入れ方を書きます。確認日は2026年9月11日。

youtube-automation-agentとは——8体で1本を作る

作者は darkzOGx。READMEでの呼び名は AgentTube。MITライセンス。GitHubのスターは3.3k、月間Trendingでは今月1,323スター増（オープンソース研究所の月次キューに記録した取得値）。

中身は、役割の違う8体のエージェントです。

Content Strategy（傾向を見て題材を決める）、Script Writer（つかみと筋を書く）、Thumbnail Designer（サムネのA/B案）、SEO Optimizer（タイトル・説明・キーワード）、Production（音声・画像・動画の組み立て）、Discoverability（任意のSEO監査）、Publishing（アップロードと予約）、Analytics（成績を戻す）。

流れは、調査→台本→ナレーションと画像→動画の組み立て→メタデータ→レビュー→予約→公開→分析。

つまり、1本の動画を作る工程を役割ごとに8つに切って、それぞれにAIを置いた構成です。うちのAI社員も同じ考え方で分けているので、ここは読んでいて納得しました。

何が自動で、何が人に残るか——3つの関所

ここが、この道具の性格を決めるところです。

READMEによると、承認ゲートは既定で有効で、生成された動画は次の3つを通ってから公開されます。

事実チェック——台本の主張を検証済みの出典に紐づける。

メディアの権利確認——画像・動画の著作権の状態を確かめる。

人のレビュー——Review Studio で最終確認する。

コメント対応にも同じ性格が出ています。Engagement studio はコメントを同期して分類し、返信の下書きを作りますが、「never auto-posts」＝自動では投稿しない。

いや、それじゃ「自動化」じゃないでしょ？

私も最初はそう読みました。でも、自動化されているのは「作る」工程のほうで、「出す」判断だけが人に残っている。これは、AIエージェントを業務で回すときの一番安全な形です。うちも、AIが作った成果物の最後のボタンは人が押しています。

STEP1: 入れる——5つのコマンド

必要なものは、Node.js 18以上、YouTube Data API の認証情報を持つGoogleアカウント、AIのテキスト系プロバイダのAPIキーを最低1つ。FFmpegは ffmpeg-static で自動で入り、Python 3.9以上は任意（DarkzSEOという別ツールと連携するときだけ）。

READMEのQuick Startは5行です。

git clone https://github.com/darkzOGx/youtube-automation-agent.git
cd youtube-automation-agent
npm install
npm run walkthrough
npm start

npm run walkthrough は対話式のセットアップで、各AIプロバイダの選び方を説明し、認証情報をテストし、YouTubeの認可まで案内する、とあります。短い従来の流れが npm run setup。

起動したら、ダッシュボードは http://localhost:3456。主なタブは Autonomous Operator、Production readiness、Review Studio、Analytics、Engagement。

STEP2: 鍵を決める——無料で試せる範囲

.env に入れる主なキーは、OPENAI_API_KEY、GEMINI_API_KEY、OPENROUTER_API_KEY、ELEVENLABS_API_KEY と ELEVENLABS_VOICE_ID、YOUTUBE_REGION（既定は US）、DEFAULT_PRIVACY_STATUS（動画の既定の公開設定）、PORT（既定3456）など。

無料で試すなら、READMEはこう書いています。「Gemini offers free access for supported text and TTS usage」——Geminiは対応するテキストとTTSの利用に無料枠がある。ただし画像生成は有料の層が要る。

動画生成（Seedance、MiniMax、Kling、Wan）は別のプロバイダで、VIDEO_MAX_GENERATED_SECONDS で生成秒数の上限を決めます。既定はローカルのスライドショー。有料プロバイダを選ぶときは別途確認が要る、とあります。

本番の前に、Production readiness タブで無料のプローブ（疎通確認）を回すのが推奨されています。画像のプローブだけは「AI image generation can incur a larger provider charge」＝大きめの課金が起きうるので、チェックボックスでのオプトイン。

YouTube側は、Google Cloud Console でプロジェクトを作り、YouTube Data API v3 を有効にし、OAuth 2.0 クライアント（デスクトップアプリ）を作って、JSONを config/credentials.json に置く。

STEP3: 目的を1つ置く——Autonomous Operator の使い方

チャンネルを自律で回すときは、タスクの一覧ではなく「目的」を置きます。

READMEの言葉では、「set the objective, audience, content pillars, publishing cadence, success metric」——目標（登録者や再生など）、対象、コンテンツの柱、公開の頻度、成功の指標。これを置くと、戦略に沿った企画が自動で回る。

ただし、前の節のとおり、自律モードでも3つの関所は迂回しません。回るのは企画と制作。出すのは人。

うちなら、最初の目的は「登録者」ではなく「週1本、人のレビューを通る動画を出す」に置きます。指標を先に大きくすると、関所で止まる本数だけが増える。

途中で止まったときの保険も書かれています。ローカルのSQLiteにチェックポイントを取るので、中断した制作を途中から再開できる。Scene Repair Studio で場面を個別に直せる。承認済みの動画から Shorts Repurposing Studio で縦型（9:16）を作れる。

使ってみて気をつけること——READMEの免責と、うちの見方

READMEには、Legal の節にこう書かれています。「This tool is for legitimate content creation. Comply with YouTube's Terms of Service and Community Guidelines.」

AIで作った動画を量産して出す使い方は、この一文と、3つの関所の設計に反します。道具の設計が「人が出す」になっているのは、作者がそこを分かっているからだと私は読みました。

もう1つ。8体のエージェントは、それぞれがAPIを叩きます。1本あたりの費用は、選ぶプロバイダで桁が変わる。最初の1本は、Gemini無料枠＋ローカルスライドショーで通して、ダッシュボードの Production readiness で何が課金対象かを見てから、プロバイダを足す。この順が安全です。

自社で回しているわけではないので、以上は「うちならこう試す」の提案として読んでください。

よくある質問

「コーディング不要と書いてあるけど本当？」

Quick Start の5行を打つのと、.env にキーを書くのは要ります。コードを書く必要は無い、という意味で読むのが正確です。

「何本くらい自動で出せる？」

READMEに本数の目安はありません。関所を通る本数が上限で、それは人のレビューの速さで決まります。

「Shortsだけ作りたい」

承認済みの動画から Shorts Repurposing Studio で縦型を作る流れなので、先に横型を1本通す必要があります。

まとめ：youtube-automation-agentの使い方は「作るは機械、出すは人」

8体のエージェントが調査から予約まで回す。既定の承認ゲートが、事実・権利・人のレビューの3つで止める。無料で試すなら Gemini のテキストとTTS、動画はローカルのスライドショーから。

今日やるなら、npm run walkthrough まででいいです。認証が通り、ダッシュボードが開いたら、Production readiness で無料のプローブだけ回してみてください。何が課金になるかが先に分かります。

▶ 関連記事: swarm-forgeの使い方【Uncle Bobの6役構成】——AIエージェントを部屋で分け、引き継ぎで繋ぐ

▶ 関連記事: firstmateの使い方——話しかけるのは1体だけ、作るのは別々の作業場にいる船員たち

OSSを実務で活用するための6大特典

OSSの選び方や、AIが作ったものを人が止める関所の設計を整理したい方へ。活用を進めるための6大特典をご案内しています。

👉 OSS活用の6大特典を見る