【無料・OSS】YouTube の要約を自分のメールへ届けるアプリをプレゼント！（Cloud Shell / Python / MIT）
まず Cloud Shell を開く: https://shell.cloud.google.com/?hl=ja&fromcloudshell=true&show=ide%2Cterminal
（日本語 UI・IDE とターミナルを表示。Google アカウントでログイン後、下の git clone を実行できます）
「長い YouTube、とりあえず要約だけ自分のメールで受け取りたい」——そんな人向けに、ストアのアプリではなく git clone でもらえるオープンソース（MIT） としてまとめました。拡張機能なし・Selenium なし。手元に Python を入れ直さなくても、Google Cloud Shell のブラウザ環境だけで試せます。シェアやスターで広まればうれしいです。
本編と同じソース: sinzy0925/py_youtube-transcript-api（MIT）— スター・Issue 歓迎です。
※ここでの 「無料」 は、Cloud Shell の標準クォータ内や Gemini / Gmail まわりの各サービスが提供する無料枠の範囲を指します。要約には Google AI Studio 等の Gemini 用 API キーが別途必要です（枠・課金は公式の条件に従います）。
上記の Cloud Shell 直リンクでも、公式の Cloud Shell 案内 から入っても同じです。追加のサーバ契約やローカルへの Python 入れ直しなしで、ブラウザから 無料（標準の利用クォータ内）の Linux 環境に入れます。次の 1 行でリポジトリを取得すれば、そこがそのまま作業ディレクトリになります（Git も Cloud Shell に入っていることが多いです）。
git clone https://github.com/sinzy0925/py_youtube-transcript-api.git
cd py_youtube-transcript-api のあと .env を置いて run_pipeline.sh を実行すれば、仮想環境（.venv）の作成と pip install -r requirements.txt までスクリプト側でまとめて行うので、手元の PC に Python を入れ直さなくても、Cloud Shell 上で YouTube 動画の字幕取得 → Gemini による要約までを比較的かんたんに試せます。※要約には Google AI Studio 等で取得する Gemini 用 API キーが別途必要です（無料枠・課金は各サービスの条件に従います）。リポジトリは sinzy0925/py_youtube-transcript-api（MIT）です。
要約
ブラウザ拡張なし・Selenium なしで、
- 指定 YouTube 動画の字幕を取得（youtube-transcript-api）
- Gemini で長文要約＋真実度（目安）% 付与（JSON／検索グラウンディング可）
- 任意で Gmail に
transcript/summary/ 字幕 vtt などを添付送信
までを 1 コマンド（または run_pipeline.sh 1 本）で回せる小さなスクリプト集です。
複数本の GOOGLE_API_KEY_N をローテーションするマネージャ（m03）入り。
こんな用途向き
- 勉強会・解説動画の内容を要約して残したい（メールやフォルダに）
-
字幕だけ抜きたい（
text/json/vtt） - クラウド上（Google Cloud Shell 等）の Bash から回したい
- すでに Gemini API や Gmail アプリパスワード を使っている人
特徴（ざっくり）
| 内容 | 説明 |
|---|---|
| 字幕 | 公式非公開の内部 API 相当を叩く定番 Python ラッパー利用（無料、別途 API キー不要） |
| 要約 |
google-genai で a02 共通プロンプト → a03 で生成。モード brief / detailed / minutes / custom
|
| 真実度 | 要約前の全文に対し追加で Gemini 呼び出し。.env で検索付きON/OFF可。地政学解説を安易に「架空扱い」しにくいプロンプト調整入り（目安） |
| メール |
a04 で HTML 本文＋添付。Markdown の summary も拡張があれば HTML 化 |
| キー |
m03_api_key_manager で GOOGLE_API_KEY_1 番台をセッションファイル付きでローテ |
全体の流れ
URL / video_id
→ a01 字幕 + transcript.txt + subtitle_*.vtt
→ oEmbed でタイトル + video_info.json
→ a03 真実度（任意）+ 要約 → summary.txt
→ a04 （任意）Gmail
ファイル名の a01 〜 a05 は実行順の目安。a02 はプロンプト定義の import 用（単体起動しません）。
必要なもの
- Python 3.10+（3.12 / 3.13 想定）
- Git からクローン可能な環境
- Google Gemini 用 API キー（AI Studio 等）
-
メールまでやる場合
- Gmail アドレス
- 2 段階認証＋アプリパスワード（16 文字、通常ログインパスワードではない）
-
ネット接続（YouTube / Google API / oEmbed 用
requests）
注意（字幕）
一部データセンターや クラウド IP からは、YouTube 側の制限で RequestBlocked 等になることがあります。README のプロキシ案内を参照するか、自宅回線で試してください。
セットアップ
Google Cloud Shell で環境を用意する場合（手早い）
ブラウザで Cloud Shell を開く（日本語・IDE＋ターミナル） し、ログイン後のターミナルで 次の流れだけでも動かせます。run_pipeline.sh が .venv と依存パッケージまで面倒を見ます。
git clone https://github.com/sinzy0925/py_youtube-transcript-api.git
cd py_youtube-transcript-api
# リポジトリ直下に .env を作成（後述の「.env の置き方」）
chmod +x run_pipeline.sh
./run_pipeline.sh "https://www.youtube.com/watch?v=動画ID"
ローカルなど：手動で venv する場合
git clone https://github.com/sinzy0925/py_youtube-transcript-api.git
cd py_youtube-transcript-api
python -m venv .venv
# Windows: .venv\Scripts\activate
# Linux / macOS: source .venv/bin/activate
pip install -r requirements.txt
依存（requirements.txt）: youtube-transcript-api, requests, google-genai, python-dotenv
.env の置き方（推奨）
リポジトリ直下に .env（必ず .gitignore 済み。コミット禁止）。
最低限（メール送信まで行う場合）
要約＋Gmail 送信まで回すときに、まず揃えたい変数です。値は実物に置き換えてください。
GOOGLE_API_KEY="あなたのAPIキー"
TRUTH_ASSESSMENT_GROUNDING=1
TO_EMAIL="あなたのメルアド"
GMAIL_USER="送信元のメルアド"
GMAIL_APP_PASSWORD="送信元のGmailのアプリパスワード"
-
GMAIL_APP_PASSWORDは Google が発行する アプリパスワード（16 文字・スペースなしで記載推奨）。普段の Gmail ログインパスワードではありません（2 段階認証を有効にしたうえで「アプリ パスワード」から発行）。 - 宛先は
TO_EMAILのほかMAIL_TOでも可（どちらか一方があればrun_pipeline.shはメール送信ルート）。 -
メール不要なら
TO_EMAIL/MAIL_TOは空のまま。run_pipeline.shは自動で--skip-email。その場合の最低限はGOOGLE_API_KEYだけで足ります（TRUTH_ASSESSMENT_GROUNDINGは省略可・未設定は検索グラウンディング ON 扱い）。
例：複数 API キーや別名を使う場合（値は仮。実キーに差し替え）
# Gemini（m03 は GOOGLE_API_KEY_1, _2, ... 番号付き推奨）
GOOGLE_API_KEY_1=your_key_here
# GOOGLE_API_KEY_2=...
# 任意: API_KEY_RANGE=1-3 など
# パイプラインの送り先（a05 / run_pipeline.sh 判定用）
MAIL_TO=your.email@gmail.com
# Gmail 送信
GMAIL_USER=your.gmail.sender@gmail.com
GMAIL_APP_PASSWORD=xxxxxxxxxxxxxxxx # アプリパスワード（スペースなし16文字推奨）
# 真実度で Google 検索グラウンディング（既定: 利用）
# TRUTH_ASSESSMENT_GROUNDING=0
-
m03_api_key_managerは同じ.envを読み、番号付きキーを範囲指定で切り出せます（詳細はm03_api_key_manager.py内コメント）。 -
プッシュ前に
.envがステージに乗っていないかgit statusで確認。GitHub の secret scan に引っかかると拒否されるので、キーはリポジトリに入れない。
使い方（詳細）
1. 一括パイプライン（いちばん手軽）
メール付き（--to か環境変数 MAIL_TO / TO_EMAIL）:
python a05_pipeline_youtube_to_email.py --to 宛先@example.com "https://www.youtube.com/watch?v=動画ID"
要約・字幕までは出して、メールは不要:
python a05_pipeline_youtube_to_email.py --skip-email "https://youtu.be/xxxx"
成果物のフォルダ（省略時は output/日時_動画ID先頭8文字/）:
python a05_pipeline_youtube_to_email.py --skip-email -o ./my_out "https://www.youtube.com/watch?v=xxxx"
a05 主なオプション
| オプション | 内容 |
|---|---|
video |
第 1 引数。watch URL / youtu.be / 11 文字の video_id |
-o, --output-dir
|
出力ディレクトリ。未指定は output/… 自動 |
--to |
送信先メール（使う場合。未使用なら MAIL_TO 等） |
-l, --languages
|
字幕の優先言語。例: -l ja en（デフォルト ja en） |
--prompt-mode |
brief / detailed / minutes / custom（デフォルト detailed） |
--prompt-text |
custom のときの本文用追記 |
--skip-email |
メールを送らない |
--skip-truth-assessment |
真実度用の追加 Gemini 呼び出しを行わない（要約だけ） |
※ MAIL_TO も TO_EMAIL も空で、かつ --skip-email も付けていないと、送信先未指定で exit 2 になります。
2. 字幕だけ取りたい（CLI）
# 例: 利用可能な字幕一覧
python a01_get_transcript.py "URL" --list
# プレーンテキスト
python a01_get_transcript.py "URL" -f text
# JSON / vtt
python a01_get_transcript.py "URL" -f json
python a01_get_transcript.py "URL" -f vtt
- 第 1 引数を省略すると、リポ内のサンプル用デフォルト URL（開発者向け）にフォールスします。本番利用では必ず URL か ID を付けてください。
- PowerShell では
?付き URL は 必ずクォート（"https://...?si=..."）。
3. Bash ワンショット run_pipeline.sh（仮想環境まで）
Git Bash / WSL / Google Cloud Shell 等で。引数は動画 URL（または video_id）だけです。
chmod +x run_pipeline.sh
./run_pipeline.sh "https://youtu.be/xxxx?si=...."
- 同ディレクトリの
.envをシェルに展開してからa05を起動するので、MAIL_TOまたはTO_EMAILが.envだけでも メール送信ルートに入れます。 -
.envにMAIL_TOもTO_EMAILも無い場合は、自動で--skip-email。 -
nohupがある環境（Linux / Cloud Shell など）:batch1.log（リポジトリ直下）へログを取りつつnohup+python -u+ バックグラウンドで実行し、PID を表示して終了。ブラウザを閉じても処理が残りやすいです。進捗はtail -f batch1.logなどで確認。 -
nohupが無い環境: エラーにせず フォアグラウンド実行（端末を閉じると停止）。 - 仮想環境に pip が無い場合は
ensurepip/get-pip.pyで 自動ブートストラップ（外向きネットワークが必要なことがあります）。 -
batch1.logは.gitignore済み（コミットされません）。ログ名を変えたい場合はrun_pipeline.shのPIPELINE_LOGを編集。 - Windows では
py -3を優先（Store の空のpython3スタブで venv が壊れないよう対策）。 - 仮想環境は
.venv/Scripts/python.exe（Win）or.venv/bin/pythonを直接呼び、activateに依存しない実装。
成果物（イメージ）
output/2026xxxx_xxxxxxxx/ 配下の例:
| ファイル | 内容 |
|---|---|
transcript.txt |
プレーンテキストの全文 |
subtitle_ja.vtt 等 |
WebVTT 形式の字幕 |
summary.txt |
真実度ブロック＋要約（先頭に「約◯%」風、設定による） |
video_info.json |
タイトル・video_id・取得日時 等 |
うまくいかないとき
| 現象 | 想定原因と対策 |
|---|---|
| 字幕取得で IP ブロック | 別ネット / ドキュメントのプロキシ |
| Gemini 429 | クォート超過。m03 の別キーに切替・時間を空ける。a03 にキー再試行ロジックあり |
| 真実度の「検索+JSON」が 400 | 一部モデルはツールと application/json 併用不可。a03 側で JSON 単独等へフォールバック |
| push が拒否される | 履歴に .env 混入。キーローテ + git filter-repo 等で履歴掃除、または GitHub 案内の解除フロー（根本はキー再発行） |
run_pipeline.sh がすぐ落ちる |
Windows では python.org 版の Python 推奨。python3 だけの Store スタブに注意 |
No module named pip（Cloud Shell 等） |
スクリプトが ensurepip / get-pip.py で復旧を試みます。古い .venv だけが壊れている場合は rm -rf .venv 後に再実行。curl / wget と外向き HTTP を確認 |
| バックグラウンド実行のログが見えない | Linux / Cloud Shell では batch1.log を参照。nohup が無い環境ではフォアグラウンドのみ |
真実度・要約の注意
- 要約も真実度の数値も、大規模言語モデルが返す推定です。裁判・医療・投資などの根拠には使わないでください。
- 地政学や時事解説を、誤って「小説的架空」扱いしにくいようプロンプトは調整済みですが、誤答は起こり得ます。
ライセンス
リポジトリ内のオリジナルは MIT です。
youtube-transcript-api 等の依存は、各作者のライセンスに従います。
おわりに
「動画を見る時間はないが、内容とファイルだけ手元に残したい」という用途向けの自分用ツールから切り出したものです。同じ悩みの方の参考になれば幸いです。
- リポジトリ: https://github.com/sinzy0925/py_youtube-transcript-api
- Issue / PR も歓迎（仕様の相談可）
（Qiita 投稿時は、タグ例: Python YouTube Gemini Gmail youtube-transcript-api などを付与すると捗ります。表やコードブロックはこのまま貼れます。タイトルは記事化時に 60 文字前後に整えるとよいです。）