Orkas Orkas
首頁 博客 YouTube MCP:字幕、頻道與權限
產品

YouTube MCP:字幕、頻道與權限

讀公開影片字幕、查頻道資料和上傳影片,需要不同工具與權限。先選任務,再配置連接。

YouTube MCP 給 AI 提供一組具體的 YouTube 工具,名字相同不代表能力相同。字幕服務器可能只能讀公開影片字幕,沒有帳號登錄或上傳工具;帳號連接器可能使用 OAuth,提供的是另一組操作。

創作者和小商家應先確定成果:帶出處的影片摘要、自己的頻道清單,還是待審核的上傳素材包。不要按工具數量選服務。本文於 2026 年 11 月 12 日核對公開文檔,沒有宣稱真實帳號連接或上傳實測。

按資料與權限選連接

目的所需連接要核對的邊界
總結公開影片能讀字幕的服務器字幕是否可用、時間戳覆蓋是否完整,不保證每個影片都可讀
查公開標題、播放量和評論YouTube Data API,通常使用 API Key額度、分頁和公開資料範圍
讀私有帳號資料或改頻道帶正確範圍的 OAuth 與對應工具實際帳號、頻道與獲准操作
看留存或收入對應分析服務或授權導出公開影片統計不是私有 YouTube Analytics

Claude Desktop 的一個具體社區方案

Promethic-Labs/youtube-mcp 提供桌面擴展,文檔中的步驟是:

  1. 閱讀倉庫,從其鏈接的 GitHub Release 下載 YouTube.mcpb。
  2. 用 Claude Desktop 打開,核對安裝資訊。
  3. 該實現讀字幕不需要 API Key;公開搜索和元資料工具需要在擴展設置里填 Google 項目的 YouTube Data API Key。
  4. 新開啓用連接器的對話,先查看實際工具,再讀一個你熟悉的公開影片。

維護者說明,桌面擴展使用應用自帶執行環境;單獨的源碼或 CLI 路線則需要 Node 和構建步驟。不要把擴展檔案填到遠程連接器 URL 中。官方桌面擴展說明介紹了這個本地安裝入口。

這是一條讀公開資料的路線,不代表應給它頻道寫權限。列出的工具包括字幕、影片與頻道資訊、評論、播放列表;能讀公開播放列表,不代表能修改播放列表。

第一個研究任務要保留證據

讀取這三個影片網址,輸出表格:網址、發佈日期、主要觀點和支持它的字幕時間戳。注明缺失字幕與覆蓋缺口;為我們的下一條商品教程提三個原創角度,把來源事實和你的建議分開。不要回評論或上傳影片。

這是示例請求,不是實測結果。逐條檢查時間戳是否存在、是否支持觀點。標題和簡介不是字幕;只能讀到這些時,報告應寫明。如果使用評論,保留樣本量與排序方式,不要把幾條熱門評論稱為“觀眾都這麼想”。

比較頻道表現時,也要控制影片年齡。昨天發佈和去年發佈的影片,積累播放量的時間不同。保留發佈日期、可比時間窗和讀取時間,不要只憑總播放量就認定某種標題導致了表現變化。

字幕、API 與配額,別混成一件事

Google 的官方字幕下載介面要求用戶有影片編輯權限,社區服務器讀取公開播放器字幕是另一條實現。後者可能因字幕缺失、影片限制或 YouTube 內部介面變化而失敗。“字幕不需要 Key”不等於官方授予無限字幕訪問。

官方 API 的公開資料請求通常由 Key 標識項目;私有資料和修改操作需要 OAuth。登錄頻道也不能讓不存在的字幕憑空出現。

配額說明很容易過時。社區 README 仍有較舊的搜索成本表,Google 當前配額計算說明已把搜索與上傳桶同其他介面分開。應查 Google 當前文檔和自己的控制台,不能統一按“所有調用共享每天一萬單位”估算。分頁也會消耗請求,先用限定條數的清單,不要直接抓完整頻道。

在 Orkas 中用 YouTube 連接器

Orkas 連接器目錄包含 YouTube。打開連接器,搜索 YouTube,完成界面提供的授權並確認狀態;為當前任務選中後,先問有哪些操作,再做小範圍讀取。實際工具取決於授權和已連接服務,目錄描述不能證明每段字幕、每項指標或上傳都能成功。

可以逐步完成研究、提綱、腳本、影片草稿和待審核上傳包。把有來源的研究與確認過的商品事實交給寫作或 VideoStudio agent,標題、簡介、封面和可見性選項一起審。本文沒有證明自動發佈流程,也沒有宣稱 YouTube 已在 Orkas 中實連成功。

剪輯步驟見Claude 影片剪輯 skill;完整製作任務見Orkas 影片生產。

失敗時先定位原因

現象檢查什麼
沒有字幕檢查播放器是否有字幕、工具請求的語種或軌道,缺少的證據明確標注。
公開搜索失敗檢查 API 是否啓用、Key 限制與項目當前配額。
頻道不對讀私有資料或寫入前,核對授權帳號和頻道身份。
數字對不上對齊影片、指標定義、時間段和讀取時間,考慮更新延遲。
沒有上傳或編輯工具查看真實工具清單及 OAuth 範圍,不要假設只讀連接器必然含寫入。

常見問題

YouTube MCP 都是 Google 官方的嗎?

不是。本文舉例的是社區項目。Google Data API 來自官方,但它的封裝不會自動變成官方產品。

能讀每個公開影片的字幕嗎?

不能。字幕可能缺失、受限或不適用於該獲取方式;官方字幕下載 API 還需要編輯權限。

有 API Key 就能上傳嗎?

不能。私有資料和修改操作需要適當 OAuth 授權,以及實際提供該動作的工具實現。

公開播放量能代替留存資料嗎?

不能。它不能說明觀眾在哪一秒離開或收入來源;這些問題需要授權分析資料或導出。

來源與範圍

社區服務器與工具表;Google 的字幕下載、授權和配額文檔,2026 年 11 月 12 日核對。配置步驟來自文檔,本次沒有連接 YouTube 帳號;字幕讀取和上傳均未作為實驗結果展示。

Reddit MCP →

從研究走到影片任務把網址、時間戳和已確認的商品事實一起保留。發佈前審核完整素材包。
免費下載 Orkas