# YouTube ツール（GetYouTubeTranscript / SearchYouTube）

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

## SearchYouTube — 動画検索

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

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

## GetYouTubeTranscript — 字幕取得

```js
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）も対応