ytextract は何をしますか？
🎬 Playwright 駆動の CLI と AI エージェントスキルを使用して、YouTube の「字幕を表示」パネルからトランスクリプト（単一動画またはプレイリスト）を抽出します。
概要
ytextract は YouTube のトランスクリプトを抽出するためのツールです。Playwright を使用してブラウザを自動操作し、YouTube の「字幕を表示」機能からテキストを取得します。単一の動画またはプレイリスト全体のトランスクリプトを取得でき、結果は標準出力またはファイルに保存できます。さらに、AI エージェントのスキルとしても動作するため、自然言語で指示するだけでトランスクリプトを取得できます。
インストール
# npm を使用してインストール
npm install -g ytextract
# または、リポジトリをクローンしてセットアップ
git clone https://github.com/Nabil-MEDIOUNI/ytextract.git
cd ytextract
npm install
使用方法
CLI として
# 単一の動画からトランスクリプトを抽出
ytextract --url "https://www.youtube.com/watch?v=VIDEO_ID"
# プレイリストからトランスクリプトを抽出
ytextract --playlist "https://www.youtube.com/playlist?list=PLAYLIST_ID"
# 出力をファイルに保存
ytextract --url "https://www.youtube.com/watch?v=VIDEO_ID" --output transcript.txt
AI エージェントスキルとして
このツールは AI エージェント（Claude Code、Cursor、Codex など）のスキルとしても利用できます。エージェントに対して以下のような指示を与えることでトランスクリプトを取得できます。
# 例: AI エージェントへの指示
「https://www.youtube.com/watch?v=EXAMPLE_ID のトランスクリプトを取得して」
エージェントは自動的に ytextract コマンドを実行し、結果を返します。
オプション
| オプション | 説明 |
|---|---|
--url | 単一の YouTube 動画の URL |
--playlist | YouTube プレイリストの URL |
--output | 出力ファイルのパス（省略時は標準出力） |
--help | ヘルプを表示 |
動作の仕組み
- Playwright を使用してヘッドレスブラウザを起動
- 指定された YouTube 動画ページを開く
- 「その他」メニューから「字幕を表示」をクリック
- トランスクリプトパネルからテキストを抽出
- 結果を標準出力またはファイルに出力
注意事項
- 対象の動画にトランスクリプト（字幕）が存在する必要があります。
- YouTube の UI 変更により動作しなくなる可能性があります。
- 大量のリクエストを行う場合は、YouTube の利用規約を遵守してください。
ライセンス
MIT