INSTALL

安裝

最小安裝

MINIMUM

pip install reel-scout

ffmpeg 必須在 PATH 上（macOS：brew install ffmpeg）。 yt-dlp 隨套件一起裝。

裝完先跑這個，它會把每一項依賴與設定的現況列出來—— 缺什麼、哪個環境變數沒設，一次看完：

reel-scout config check

EXTRAS

每一項都是獨立的 extra，用到才裝。不裝不會壞，只是那一層會是空的（reel-scout db health 會告訴你哪一層空著）。

Extra	給什麼
whisper	faster-whisper 語音轉錄（無原生字幕軌時才需要）
audio	音訊事件偵測＋ BPM／能量。⚠️ 裝了也預設不跑，見下
ocr	燒錄字幕的 OCR
diarize	講者分離
instagram	IG 的備援抓取路徑

pip install "reel-scout[whisper]"

⚠️ 音訊事件偵測預設是關的——它要另外下載一顆約 312 MB 的模型檔，不是每個人都需要。所以你照著跑，看到的會是三步而不是四步。要開就在指令後面加：

reel-scout analyze <url> --no-skip-audio

開了之後它會給你一條聲音的時間軸（說話／音樂／音效），每一格附一個信心值。 信心值就是它的誠實度——高的可以用，低的是它在猜。實測過：低信心那批幾乎全是誤判（把淋醬的聲音認成漱口）。

MCP · SKILL

pip install 給你 CLI。要讓 Claude Code、Codex 或 Claude Desktop 直接驅動它，裝 MCP server——不必手改任何設定檔：

reel-scout mcp install

⚠️ 網頁版與手機 App 連不到。 MCP server 是跑在你自己這台電腦上的一個程式，所以只有桌面端的 agent 走得到它——claude.ai 的網頁介面與手機 App 都不行。那兩個要用就走下面的「沒有 GPU 怎麼辦」或直接螢幕錄影配提示詞。

接上之後有 19 個工具可以在對話裡直接用。另外還有 skill，那是給 agent 讀的那一半：流程、能力對照表、以及六份反解 prompt。

reel-scout skill install
# 重開 agent，然後：
/scout https://www.instagram.com/reel/XXXXXXXX/

NO LOCAL MODEL

不需要。抽關鍵楨是 ffmpeg 做的，所以在任何模型跑之前楨就已經存在了—— 讓你的 agent 自己看那些楨、自己套評分標準，再寫回資料庫：

reel-scout ingest vision <id>
reel-scout ingest analysis <id>
reel-scout ingest score <id>

沒有 API 金鑰、沒有雲端、沒有 GPU。

BEFORE YOU START

兩件會實際影響你的：Instagram 有登入牆（要匯出 cookies），以及 macOS 上的語音轉錄是純 CPU、長片會比即時還慢。兩者的做法與繞法都在誠實清單。