maestro/docs/tools/getyoutubetranscript.md

YouTube ツール（GetYouTubeTranscript / SearchYouTube）

YouTube の動画情報・字幕を取得する。

SearchYouTube — 動画検索

SearchYouTube({
  query: "ローカル LLM ベンチマーク",
  limit: 10
})
// → 動画タイトル・URL・チャンネル名・再生回数・投稿日 のリスト

検索結果は概要のみ。動画の中身を知りたい場合は GetYouTubeTranscript で字幕を取る。

GetYouTubeTranscript — 字幕取得

GetYouTubeTranscript({
  url: "https://www.youtube.com/watch?v=xxx"
  // または video_id: "xxx"
})
// → タイムスタンプ付きの字幕テキスト

重要: 動画の内容を扱う場合は必ず字幕を取得

調査タスクで「YouTube 動画について書く」場合:

• ❌ 動画タイトルやサムネイルから推測して書く
• ❌ 内部知識や他サイトの情報で代用する
• ✅ 必ず GetYouTubeTranscript で実際の字幕を取得して引用する

字幕がない動画（自動字幕も無い）は「字幕なし」と明記し、内容を書かないか別の情報源を探す。

出力フォーマット

タイムスタンプ付き:

[00:00] こんにちは、今日は...
[00:15] 最初に説明するのは...
[01:30] 結論として...

引用時はタイムスタンプも示すと信頼性が上がる。

トラブルシューティング

• 字幕が取れない: 字幕無し動画。動画 ID を確認、または別動画を探す
• 権限エラー: 一部地域制限がある動画。代替を探す
• URL 形式: 短縮 URL（youtu.be/xxx）も対応