
YouTubeの誘惑で時間を溶かさないために、専用の再生アプリをAIと一緒に育ててみた(動画取得編)
YouTubeを開くたびに別の動画に吸い寄せられる
外出から帰って料理して食事を済ませ、お風呂から上がって一息つく。夜20時からYouTubeを眺めるのは、毎日の楽しみのひとつです。
「今日更新されたお気に入りチャンネルの新着動画を、1本ずつ落ち着いて見よう」と思ってブラウザを開きます。
ところが、YouTube画面を開いた瞬間に、面白そうな動画がずらりと並びます。気になるサムネイルや興味を惹かれる企画が視界に入り、ついついクリックしてしまいます。1本見終わるとまた次の動画が出てきます。
気付いたときには1時間も2時間も経っています。見るつもりだった動画にはたどり着いていないこともよくあります。夜の貴重な自由時間が、YouTubeの提案する動画を眺めるだけで過ぎてしまい、寝る前にため息が出ます。
さらに困るのが、深夜のゲリラ配信や突発的な生放送です。あとで見ようと思っていても、アーカイブが残らず非公開になっていて見逃してしまうこともしばしば。
そこで、以下のような仕組みがあればよいと考えました。
夜20時から見始めるのに合わせて、19時にバックグラウンドでお気に入りチャンネルの新着動画を保存しておく
ブラウザでローカルサーバーを開くと、YouTube風の画面で保存済み動画が一覧表示される
お気に入りチャンネルの新着動画をローカル画面で先に見終えて、時間に余裕があればYouTubeの本家サイトを開くようにすれば、無関係な動画に時間を取られなくて済みます。
一気に作ろうとせず、少しずつ組み立てる
アプリを一から手作業で作るのは時間がかかります。とはいえ、AIに「YouTube風アプリを作って」と最初から一度にすべての指示を一括で投げると、途中でコードが省略されたり、意図しないところでエラーが出たりして止まってしまいます。
そこで今回は、機能を1つずつ作っては動かし、エラーが出たらAIに相談しながら進める対話型のステップ形式で進めます。
機能を作るためのプロンプト
動作確認のためのプロンプト
つまずきと修正プロンプト
再確認のためのプロンプト
この対話を繰り返しながら、少しずつアプリを育てていこうと思います。
AIとの会話は、最初から最後まで同じチャット画面(同一スレッド)に入力していきます。過去のやり取りや作成したコードの前提が引き継がれるため、短い追加プロンプトで機能を拡張できます。
今回は、土台となる「複数チャンネルから通常動画・ショート・ライブ配信アーカイブを保存し、差分更新や失敗リトライにも対応した取得エンジン」を作ります。
筆者の作業環境と進め方
筆者は今回、AIがローカルのファイル操作やコマンド実行を直接行うエージェント環境(Google Antigravity)で進めています。そのため、動作確認ではAIにテスト実行を依頼する指示文を記載しています。
ブラウザ版のChatGPTやClaudeなどをお使いの場合は、出力されたコードをコピーして download.py として保存してください。その上で、ターミナルから python3 download.py (Windowsの場合は python download.py) をご自身で実行して進めます。
事前準備:yt-dlp と ffmpeg を用意する
今回の構成では、動画ダウンロード用の yt-dlp と、動画・音声を結合する ffmpeg を使用することにします。
まずは、ターミナルで yt-dlp と ffmpeg コマンドが使える状態にしておきます。
macOS (Homebrew) の場合:
brew install yt-dlp ffmpegWindows (winget) の場合:
winget install yt-dlp(wingetでは、yt-dlpのインストール時に依存関係としてffmpegも自動的に導入されます。インストール完了後は、環境変数の設定を反映させるためにターミナルを一度閉じて開き直してください)
Ubuntu (Linux) の場合:
sudo apt update && sudo apt install -y ffmpeg
sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp(Ubuntuの標準aptリポジトリにあるyt-dlpはバージョンが古くYouTubeの仕様変更に対応できないため、最新の公式バイナリを配置します)
インストール後、ターミナルで以下のコマンドを入力し、バージョンが表示されれば準備完了です。
yt-dlp --version
ffmpeg -versionなお、本記事内のスクリプト実行コマンドは python3 と表記していますが、Windowsをお使いの場合はターミナルで python または py に読み替えて実行してください。
Step 1:新着動画と詳細メタデータを取得する最小スクリプト
最初は動画とメタデータのダウンロード処理から作ります。監視したいチャンネルを一覧形式で管理し、順次新着動画を保存する仕組みを作っていきます。サンプルの指示文ではmacOS環境を前提として進めます(Windows等、他のOSを使用される場合はプロンプト内の「macOS」をお使いのOSに読み替えてください)。
1-1. 機能作成プロンプト
作業用の空フォルダを作成し、AIのチャット画面に以下のプロンプトを入力します。
yt-dlp コマンドを使って、指定した複数のYouTubeチャンネルから各チャンネルの最新動画を1本ずつダウンロードする最小限のPythonスクリプト(download.py)を作ってください。
前提条件:
- 動作環境: macOS
- システムに yt-dlp と ffmpeg がインストール済みで、ターミナルからコマンドとして実行できること
- 監視対象のチャンネルURLは channels.txt に1行1件ずつ記述して管理すること
- チャンネル名(または識別子)はURLから抽出し、保存先は videos/<抽出したチャンネル名>/ 配下に保存すること
- 各動画について、動画本体とサムネイル画像に加え、次回以降のブラウザ画面表示で使うために概要欄、公開時刻、再生回数、再生時間などの詳細メタデータをJSONファイルとして一緒に保存すること
- ブラウザで確実に再生できるよう、映像と音声を別々に取得してffmpegで1つのmp4に結合(マージ)して保存するオプションを指定すること(YouTubeの映像専用mp4が選ばれて無音になるのを防ぐため)
- すでに保存済みの動画を二重に落とさないようにダウンロード時にオプションを指定すること
- ファイルの読み書きは明示的に UTF-8 を指定し、Python標準ライブラリだけで動くことAIからは、channels.txt のURLを1行ずつ読み込んで処理する download.py が出力されます。URLからチャンネル名を抽出し、yt-dlp コマンドを呼び出す短いコードです(ブラウザ版AIをお使いの場合は、出力されたコードを download.py として保存します)。
1-2. 動作確認プロンプト
AIからスクリプトが出力されたら、まずは作業フォルダ内に channels.txt を作成し、テストとして実際のお気に入りチャンネルのURLを1行1件ずつ登録しておきます。
https://www.youtube.com/@channel1
https://www.youtube.com/@channel2登録できたら、動作確認を行います。Antigravity環境ではAIに以下のプロンプトを入力します。ブラウザ版AIをお使いの場合は、ターミナルから python3 download.py (Windowsの場合は python download.py) を実行してください。
channels.txt にテスト用のチャンネルURLを登録したので、download.py を実行して、実際に videos/ 配下にチャンネルごとのフォルダが作られ、動画・サムネイル・メタデータ(JSON)が保存されるかテストしてください。実行後、作業フォルダ内に videos/ フォルダが作成され、各チャンネルのフォルダ内に動画・サムネイル・JSONファイルが保存されます。
1-3. つまずきと修正プロンプト
ここで videos/ フォルダに保存された動画ファイル名を確認した際に、意図しない動画が保存されていることに気づくことがあります。
お使いのAIによっては、チャンネルのトップURL(https://www.youtube.com/@channelname など)をそのまま yt-dlp に渡すスクリプトを出力することがあります。
YouTubeのチャンネルのトップページでは初期状態で「ホーム」タブが表示されます。そのため、直近に投稿された最新動画ではなく、チャンネル管理者が設定した古い「チャンネル紹介動画」や縦長の「ショート動画」が先頭として認識され、それが最新動画として保存されてしまうケースがあります(AIによっては、最初から自動でURL末尾に /videos を補正するコードを出してくれることもあります)。
もし videos/ フォルダの中身を確認して、最新の通常動画ではなく古い固定動画やショート動画が保存されていたり、ターミナルのログに見覚えのある古い動画タイトルが表示されていたりした場合は、以下の修正プロンプトをAIに入力します。
各チャンネルのURLでタブ情報を拾ってしまうのを防ぐため、チャンネルURL末尾に /videos を自動補正し、正しく動画一覧から最新の動画を抽出して yt-dlp コマンドに渡すよう download.py を修正してください。また、保存された動画をPCのメディアプレイヤーで再生した際、映像は流れるものの音声が一切出ない現象が起きることがあります。
これは、YouTubeの高画質動画(1080pなど)が映像と音声で分離配信されており、AIが "--format", "mp4" と指定したことで「音声なしの映像専用mp4ストリーム」を単体で取得してしまったことが原因です。
動画から音が出ない場合は、以下の修正プロンプトをAIに入力します。
保存された動画から音が出ません。YouTubeの映像専用mp4ストリームを単体で取得してしまうのを防ぎ、映像(MP4)と音声(M4A/AAC)を別々に取得して ffmpeg で1つのmp4に結合して保存するよう、yt-dlp のオプションを修正してください(--merge-output-format mp4 や -S res,ext:mp4:m4a を活用してください)。1-4. 再確認プロンプト
修正が行われたら、再度テストを実行します。保存された動画ファイルをPCのプレイヤーで開き、映像だけでなく音声も正常に流れることを確認します。
再度 download.py を実行して、channels.txt に登録した全チャンネルから正しく最新動画(mp4)、サムネイル画像、メタデータ(JSON)が取得でき、2回目の実行では「保存済み」として高速にスキップされることを確認してください。実行後、videos/ 配下にチャンネル名のフォルダ(例: videos/@channel1/)が作られます。その中に動画ファイル、サムネイル画像、詳細メタデータ(xxxx.info.json)が保存されていれば完成です。
1-5. 保存されたメタデータの中身を確認する
動画と同じフォルダに生成された <動画名>.info.json の中身を覗いてみると、以下のような豊富な情報が綺麗に記録されています。
duration: 動画の長さ(秒数)。次回、カードの右下に「12:34」のような時間バッジを表示する際に使用します。
view_count: 再生回数。
upload_date: 公開日(YYYYMMDD形式)。
description: 投稿者が書いた概要欄の本文。動画内のチャプター情報やリンクもそのまま保存されます。
動画ファイル本体だけでなく、こうした情報も丸ごとローカルフォルダに揃えておくことで、次回のWeb画面が本格的になります。
Step 2:ショート動画・ライブ配信アーカイブへの対応
通常動画とメタデータが取得できるようになりましたが、YouTubeチャンネルには通常の横長動画だけでなく、縦型の「ショート動画」や過去の「ライブ配信アーカイブ」も存在します。これらも同じチャンネルフォルダ内に分類して取得できるようにスクリプトを拡張します。
2-1. ショート・ライブ対応プロンプト
AIの同じチャット画面に以下のプロンプトを入力し、機能を追加してもらいます。
download.py を拡張してください:
1. 各チャンネルで通常動画(/videos)だけでなく、ショート動画(/shorts)やライブ配信アーカイブ(/streams)も取得対象として巡回し、最新動画を取得できるようにしてください。
2. ライブ配信アーカイブ(/streams)を巡回する際は、配信予定の待機枠(upcoming)や現在配信中(is_live)の動画は除外し、終了済みのアーカイブのみを対象にしてください。
3. 保存先はこれまで通り videos/<チャンネル名>/ 配下にまとめ、動画本体(mp4)、サムネイル、詳細メタデータを一緒に保存してください。AIからは、/videos、/shorts、/streams の3つのタブURLを組み立てて順次チェックするコードが出力されます。
2-2. 動作確認プロンプト
スクリプトが更新されたら、動作確認を行います(AntigravityではAIに指示、ブラウザ版AIではコードを上書き保存してターミナルで実行)。
再度 download.py を実行して、各チャンネルから通常動画に加えてショート動画やライブ配信アーカイブも取得されるかテストしてください。2-3. つまずきと修正プロンプト(存在しないタブのエラー)
ここで実際に動かすと、登録したチャンネルの構成によってエラーが発生することがあります。
YouTubeのチャンネルによっては、通常動画しか投稿しておらずショートやライブを一度も行っていないチャンネル(またはその逆)が多数存在します。そうしたチャンネルに対して存在しないタブURLを指定すると、YouTube側から 404 Not Found 等のエラーが返されます。その結果、スクリプトが途中で停止してしまうことがあります。
もしターミナルでタブ取得のエラーが発生して処理が止まった場合は、以下の修正プロンプトをAIに入力します。
チャンネルによってはショートやライブを投稿しておらず該当タブが存在しない場合があります。その場合はエラーで停止させず、「タブなし」として静かにスキップして次のタブやチャンネルの処理を継続するように download.py を修正してください。2-4. 再確認プロンプト
修正が行われたら、再度テストを実行します。
再度 download.py を実行して、ショートやライブが存在しないチャンネルがあってもエラーで止まらずにスキップされ、存在するコンテンツだけが videos/ 配下に正しく保存されることを確認してください。これで、ショートやライブを投稿していないチャンネルが混ざっていても、タブの有無によるエラーで止まらずに巡回できるようになります。
Step 3:日々の運用の実用化(差分更新・リトライ)
全タブの取得ができるようになりましたが、日々の自動巡回に向けて最後に整えておきたい点があります。
起動するたびに過去の全動画を再チェックしていると、登録チャンネル数が増えた際に確認時間が長くなってしまいます。また、途中で一時的な通信切断が起きた際にスクリプト全体が止まってしまっては困ります。
そこで、以下の2点を追加して実用的な仕組みに仕上げます。
前回日時の記録と差分取得: 実行日時を記録ファイル(state.json)に保存し、次回起動時はそれ以降の新着動画のみをチェックする
エラー記録とリトライ: 通信エラー等で処理が途中で止まらないよう、失敗した動画を記録(failed.json)に残し、後から再試行できるようにする
3-1. 実用化プロンプト
AIの同じチャット画面に以下のプロンプトを入力し、運用のための機能をまとめて追加してもらいます。
download.py を実用的に拡張してください:
1. 差分更新の効率化と初回起動時の安全策:
state.json にチャンネルごとの最終確認日時を保存し、次回起動時はそれ以降に公開された新着動画を対象にするようにしてください。
新着チェック時も過去の全動画を遡らないよう、各タブの先頭から最大5本程度を検査対象とし、保存済みまたは前回日時より古い動画に当たったら走査を打ち切るようにしてください。
なお、state.json に前回の記録がない初回起動時や新しく追加されたチャンネルは、過去動画を大量にダウンロードしてしまわないよう、各タブの最新1本のみを取得して現在日時を記録(初期化)するようにしてください。
2. エラー処理とリトライ:
ダウンロードに失敗した動画(一時的な通信切断など)があってもスクリプト全体を中断させず、取得可能なメタデータは残した上で、失敗したURLと理由を failed.json に記録してください。
3. リトライ機能:
コマンドライン引数で --retry が指定された場合は、failed.json に記録された動画のみを再試行するモードで実行できるようにしてください。AIからは、state.json によるチャンネル別の日時管理と failed.json によるエラー記録、そしてリトライ機能に対応した download.py が出力されます。
初回起動時(まだ state.json に日時の記録がない状態)に無制限で新着チェックを動かすと、チャンネル内の過去の動画をすべて遡って落とそうとしてしまいます。そのため、「初回は最新1本のみを取得して日時を記録する」という初期化ルールをプロンプトで明示しておくことで、意図しない大量ダウンロードを防ぎ、運用を開始できます。また、途中で1本の動画の通信が切れた場合でも、スクリプト全体が止まることなく巡回を最後まで継続できます。
3-2. 動作確認プロンプト
コードが更新されたら、動作確認を行います。
再度 download.py を実行して、実行後に state.json に日時が記録されること、エラーが発生した場合は failed.json に保存されることをテストしてください。初回実行時には、channels.txt に登録した各チャンネルから最新の通常動画・ショート・ライブ配信アーカイブが1本ずつ取得され、state.json に実行日時が記録されます。2回目以降の実行からは、その日時以降に新しく投稿された動画のみが差分取得されるようになります。
3-3. 状態管理とリトライの仕組み
実行後、作業フォルダ内に以下の管理ファイルが生成されます。
state.json: 各チャンネルの最終確認日時が記録されます。次回実行時はこの日時以降の新着動画のみをチェックするため、登録チャンネル数が増えても無駄な通信を行わずに素早く処理が終わります。
failed.json: 通信の切断などで保存できなかったURLとエラー内容がリストで記録されます。
一時的なネットワーク不調などで取りこぼしがあった場合は、--retry オプションで再取得できます。ターミナルから python3 download.py --retry (Windowsの場合は python download.py --retry) を実行するか、AIにリトライを依頼してください。失敗した動画だけを再取得できます。
なお、投稿者によって非公開や削除になった動画は、リトライしても取得できずエラー(Private video 等)が記録され続けます。その場合は failed.json から該当のURLを手動で削除するか、AIに「非公開になった動画を failed.json から除外して」と依頼して整理してください。
今回のまとめと次回予告
channels.txt にURLを並べるだけで複数チャンネルを管理し、通常動画・ショート・ライブ配信アーカイブの動画本体と詳細メタデータを自動で分類保存する取得エンジンが完成しました。前回実行日時の記録による差分更新や、失敗時のリトライ機能も備わり、日々の自動巡回にも耐える実用的な構成になっています。
Web画面が不要な場合は、このスクリプトを実行して普段お使いの動画プレイヤー(VLCやQuickTime等)で直接開いて視聴する形でも、関連動画に邪魔されない環境として利用できます。見終わった動画ファイルをフォルダから削除しても、二重保存防止の記録が残っているため再度ダウンロードされることはありません。
次回は、今回集めたこれらのデータを使って、見慣れたYouTubeのように黒基調(ダークテーマ)のカードで一覧表示するWeb画面を作っていきます。
カードには再生時間バッジや再生回数を表示し、クリックするとその場でストリーミング再生できるプレイヤー画面をAIと一緒に組み立てていきます。
それではまた次回。