feat: initial public release (MAESTRO)

2026-06-03 05:08:00 +00:00
commit f5c7666f6b
823 changed files with 184150 additions and 0 deletions
@@ -0,0 +1,51 @@
+# 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）も対応