maestro/docs/tools/getyoutubetranscript.md
clade 7049a874f3 feat: initial public release (MAESTRO v0.1.0)
Open-source release of MAESTRO, an agent orchestration platform that runs
LLM-driven tasks through sandboxed tools, with a web UI. Apache-2.0.
See README.md and docs/ (getting-started, configuration, architecture).
2026-06-03 04:01:14 +00:00

52 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 形式**: 短縮 URLyoutu.be/xxxも対応