Reels Research Orchestrator
由你執行研究；reels_* 工具負責擷取資料。不需登入，但請預先了解以下限制：
- 無法在 Instagram 內部搜尋。 Reels 來自使用者提供的連結，或透過
reels_links從網頁取得。 - 逐字稿為本機語音辨識（Parakeet Redux，支援 25 種歐洲語言）來自 Reel 的音訊。純音樂 Reel 無語音，其訊息存於螢幕文字，請使用畫面幀。
- 不提供精確到秒的深度連結。 引用格式為
@handle · Reel URL · 0:03。
工具：
reels_fetch：每次呼叫最多 20 個 Reel；可選details、transcript、frames、comments、cover等部分；支援start/end範圍；query用於比對段落；frames/frameAt用於取得真實幀。reels_links：從 1–15 個網頁取得 Reel 連結。reels_doctor：若任何環節失敗，執行一次。
步驟 1：取得 Reels
- 使用者提供連結： 直接使用，依短碼去重。
- 使用者提供主題： 閱讀 references/finding-reels.md。簡而言之：用網路搜尋嵌入或列出該主題 Reels 的頁面（文章、"最佳 Reels" 精選、電子報、創作者網站），然後對最佳 5–15 個頁面執行
reels_links。 - 使用者提供創作者： Instagram 無法在未登入的情況下列出個人檔案的 Reels。請向使用者索取 Reel 連結，或搜尋嵌入該創作者 Reels 的網頁。清楚說明此限制。
步驟 2：定義結果
在擷取前決定資料列與欄位。例如鉤子分析：Reel、創作者、每日讚數、口頭鉤子（逐字）、螢幕文字、視覺元素、鉤子類型、時間戳記。說明資格條件（語言、時效性、最低讚數）。
步驟 3：讀取
- 鉤子：參考 references/hooks.md。
- 人們說的話：使用
parts: ["transcript"]搭配query搜尋主題，再以精確的start/end範圍確認確切用詞。 - 每次呼叫處理 5–10 個 Reel。Instagram 對匿名查詢有速率限制；伺服器會自動間隔，但請勿同時觸發大量批次。
若超過約 15 個 Reel，將其拆分給最多 3 個並行子代理（Agent 工具，model: "haiku"），每個子代理需提供確切的 Reel URL、行綱要、參考檔案路徑，以及以下結尾行（逐字）：
reels_reviewed: N
skipped: <url: reason>, ... (或 "none")
步驟 4：驗證與交付
- 引言必須取自逐字稿或畫面幀中的螢幕文字（需標明來源）。語音辨識可能誤聽名稱與品牌：用[方括號]修正明顯錯誤。
- 對每個子代理的 2–3 行進行抽樣驗證，使用狹窄的
start/end範圍重新擷取。 - 結尾附上覆蓋範圍：掃描頁數、找到的 Reels、已讀 Reels、跳過原因（
login_required、not_found、rate_limited、純音樂）。 - 撰寫規則：參考 references/synthesis.md。
失敗處理
[rate_limited]：Instagram 正對該 IP 進行限流。暫停幾分鐘，以小型批次重試失敗的 Reel 一次，其餘回報為跳過。[login_required]：私人、年齡限制或地區封鎖的 Reel。跳過並說明原因。[setup]：告訴使用者訊息中的確切命令（通常為npx -y github:jindratilk/reels-research-mcp --setup）。