【無料・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 文字前後に整えるとよいです。）