youtube

name	youtube
description	YouTube動画の字幕を取得して保存・参照する
argument-hint	<URL or video ID> [タイトル]
allowed-tools	["Bash","Read","Write","Edit","Glob","WebSearch"]

YouTube動画の字幕取得・参照

YouTube動画の字幕（transcript）を取得して .info/ref/ に保存し、内容を参照できるようにする。

引数ありの場合

URL または video ID: $ARGUMENTS

1. scripts/fetch_transcript.py を実行して字幕を取得・保存する

uv run python scripts/fetch_transcript.py "<URL or video ID>" "<タイトル（分かれば）>"

2. 保存された .info/ref/{video_id}.md を読み込んで内容を確認する
3. ユーザーの文脈（ゴール、学習中のトピック）に応じて内容を要約・解説する

引数なしの場合

1. .info/ref/ 内の保存済み動画を一覧表示する
2. ユーザーにどの動画を参照したいか聞く

動画内容の活用

字幕を取得したら、ユーザーの学習に活かす:

• レッスン動画の場合: 教えている内容を構造化して .info/knowledge/ に反映
• 演奏動画の場合: テクニックや曲の分析を行う
• 理論解説の場合: 内容を .info/knowledge/theory.md の学習素材として活用

保存先

• .info/ref/{video_id}.json - タイムスタンプ付き字幕データ
• .info/ref/{video_id}.md - 読みやすいテキスト形式

注意

• 字幕がない動画もある。その場合はエラーメッセージを伝え、WebSearch で動画の内容を調べることを提案する
• 取得する字幕は日本語優先、なければ英語