YouTube Transcript AI

ai.youtube-transcript由 youtube-transcript.ai 發布官方發布者v1.3.0更新於 Oct 29, 2026

Read YouTube transcripts and search what people say across 425k videos. Free API key.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析媒體與設計

概覽

AI 產生的概覽

託管式 MCP 伺服器,讓助理讀取 YouTube 影片字幕,並在大量影片中檢索人們實際說了什麼。

可以做什麼
  • 依連結或影片 ID 取得完整字幕,可選語言並分段續讀長影片
  • 搜尋 YouTube 影片,列出頻道或播放清單的最新影片
  • 在字幕中依關鍵字定位片段並附時間戳與跳轉連結,或一次批次讀取多部影片字幕
  • 在大型影片庫中全文檢索口說句子,並讀取上下文
  • 依話題提及次數對影片與頻道排名,並統計提及量隨時間的變化
  • 取得影片的熱門留言
適用情境
適合讓助理摘要、引用或查核 YouTube 影片內容,針對某個話題跨多位創作者做研究,或觀察某事物被提及的頻率變化,且不想在本機安裝任何東西時使用。
執行需求
遠端 Streamable HTTP 端點,無需本機安裝。需要 API 金鑰,透過 Authorization Bearer 標頭或連接器 URL 中的 key 參數傳送。免費金鑰需以 Google 帳號登入建立。影片需有字幕。免費額度每天 10 次請求;Pro 為每年 120 美元、每天 1,000 次。
安裝前請注意
API 金鑰屬於憑證:使用 URL 形式時金鑰會出現在連接器 URL 中,應將該 URL 視為機密。每次工具呼叫(包括長字幕的每一段)都計入每日額度,付費方案需要花錢。請求限速約為每 10 秒 10 次。字幕與留言來自公開字幕,與 YouTube 或 Google 無關聯。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 YouTube Transcript AI,將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/ai.youtube-transcript%2Fyoutube-transcript/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "youtube-transcript-ai": {
      "type": "http",
      "url": "https://youtube-transcript.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

YouTube Transcript MCP Server

Give Claude, ChatGPT, Cursor, Claude Code and any MCP client the ability to read YouTube transcripts. Hosted, nothing to install. Free API key: 10 requests a day.

A hosted Model Context Protocol server that exposes one tool, get_youtube_transcript, backed by youtube-transcript.ai. Paste a YouTube link mid-conversation and your AI reads the full transcript on demand.

Connector URL:

https://youtube-transcript.ai/mcp?key=YOUR_KEY

Replace YOUR_KEY with your API key. Create a free key with a Google sign-in; it takes about a minute.


Why

  • Free to start. A free key covers 10 transcripts a day. Pro is 1,000 a day for $120 a year, on the same key.
  • Reliable. A hardened fetch pipeline with proxy fallback returns transcripts even on videos that block typical scrapers.
  • Any language. Pick a caption track by language code (en, zh-CN, es, ja, …) or let it choose the default.
  • Built for agents. One tool, plain-text output with title and metadata. Multi-hour videos come back in parts, so nothing gets cut off.

Authentication

Tool calls need an API key. There is no OAuth. Send the key in one of two ways:

WhereExample
HeaderAuthorization: Bearer YOUR_KEY
URLhttps://youtube-transcript.ai/mcp?key=YOUR_KEY

The URL form is for clients that only accept a connector URL.

Quick start

Claude (web / desktop)

Settings → Connectors → Add custom connector

FieldValue
Nameyoutube-transcript.ai
URLhttps://youtube-transcript.ai/mcp?key=YOUR_KEY

Then ask: “Summarize this video: https://youtu.be/dQw4w9WgXcQ”

ChatGPT

In the custom connector / MCP server setup, add an MCP server with URL https://youtube-transcript.ai/mcp?key=YOUR_KEY (transport: Streamable HTTP), enable it for your chat, then paste a YouTube link.

Claude Code

bash
claude mcp add --transport http --scope user youtube-transcript \  https://youtube-transcript.ai/mcp \  --header "Authorization: Bearer YOUR_KEY"

Cursor

Add to ~/.cursor/mcp.json, or to .cursor/mcp.json inside one project:

json
{  "mcpServers": {    "youtube-transcript": {      "url": "https://youtube-transcript.ai/mcp",      "headers": { "Authorization": "Bearer YOUR_KEY" }    }  }}

Codex

Add to ~/.codex/config.toml:

toml
[mcp_servers.youtube-transcript]url = "https://youtube-transcript.ai/mcp"http_headers = { "Authorization" = "Bearer YOUR_KEY" }

Clients that only launch local servers

For clients that start MCP servers from a config file and cannot take a remote URL, bridge with mcp-remote:

json
{  "mcpServers": {    "youtube-transcript": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://youtube-transcript.ai/mcp?key=YOUR_KEY"]    }  }}

Let your agent do it

Paste https://youtube-transcript.ai/mcp.md into a coding agent. It is a plain-text version of these instructions, written for an AI to follow.

Tool reference

get_youtube_transcript

Fetch the full text transcript of a YouTube video.

ParameterTypeRequiredDescription
videostringyesYouTube URL (watch, youtu.be, shorts, embed) or a bare 11-character video ID
langstringnoCaption language code, e.g. en, zh-CN, es. Omit for the default track
offsetintegernoWhere to continue a long transcript. Use the value given at the end of the previous part

Returns plain text: the transcript with title, duration, and a list of available languages. Transcripts over 120,000 characters come back in parts; each part ends with a note giving the offset for the next call.

Example prompts

  • “Summarize the key points of <link> in 5 bullets.”
  • “Pull the transcript of this video and translate it to Spanish.”
  • “What does the speaker say about pricing in <link>? Quote the exact lines.”

Programmatic use

The server speaks standard MCP over Streamable HTTP (JSON-RPC). A zero-dependency example is in examples/quickstart.mjs:

bash
YT_TRANSCRIPT_KEY=YOUR_KEY node examples/quickstart.mjs https://youtu.be/dQw4w9WgXcQ

Calling from your own code without MCP? There is a plain HTTP endpoint too: see the YouTube Transcript API.

Limits

  • Free: 10 requests a day. Pro: 1,000 a day for $120 a year. Upgrade from the key page.
  • Every tool call counts as one request, including each part of a long transcript. The count resets at 00:00 UTC.
  • The video needs captions, either written by the uploader or auto-generated by YouTube.

Notes

  • Not affiliated with YouTube or Google. Transcripts are fetched from publicly available captions.
  • Listed in the official MCP Registry as ai.youtube-transcript/youtube-transcript.

Links

License

MIT

來源:README.md,提交 5c71e9f

工具

11

get_youtube_transcript

Fetch the full text transcript of a YouTube video. Accepts a YouTube URL (watch, youtu.be, shorts, embed) or a bare 11-character video ID, and returns the transcript as plain text with title and metadata. Optionally pass a BCP-47 language code to select a specific caption track. Very long transcripts (multi-hour videos) come back in parts of up to 120,000 characters: when there is more, the result ends with a note giving the offset to pass on the next call.

輸入參數langvideo必填offset

search_youtube_videos

Search YouTube and return matching videos with channel, view count and duration. Use it first when researching a topic: run several differently-worded queries (and in more than one language), then read the best hits with get_youtube_transcript, find_in_transcript or get_transcripts_batch. Optional filters on views and length.

輸入參數sortlimitquery必填min_viewsmax_minutesmin_minutes

find_in_transcript

Find where a video talks about something. Give one or more keywords and get back only the matching passages, each with a timestamp and a link that opens the video at that moment. Far cheaper than reading the whole transcript when you are looking for specific points. Matching is a case-insensitive text match, so try synonyms and spelling variants (auto-captions often mis-hear names).

輸入參數langvideo必填contextkeywords必填max_hits

get_transcripts_batch

Read the transcripts of several videos in one call (up to 5), each cut to a length you choose, so you can skim a set of search results without filling your context. Each video counts as one request against your daily quota. For the rest of a long video use find_in_transcript or get_youtube_transcript.

輸入參數langvideos必填max_chars_each

get_video_comments

Fetch the top comments of a YouTube video (YouTube's "top" ordering, replies not included), with like counts. Comments are where viewers report what worked for them, which makes them useful for checking claims made in the video.

輸入參數limitvideo必填

list_channel_videos

List the latest videos of a YouTube channel or playlist, with view count and duration. Use it to follow a creator who looks credible, or to cover a playlist.

輸入參數limitchannel必填

search_spoken_words

Search what people actually say inside YouTube videos. Full-text search over about 100 million spoken sentences from about 425,000 English-language videos (the ones users looked up on youtube-transcript.ai), with typically 1 to 8 million new sentences added every day. Returns matching sentences, each with the video, channel and a link that opens the video at that moment. Use it to find evidence and quotes, to see how people talk about a topic, product or phrase, or to find which videos mention something. Captions are auto-generated and often mis-hear names (for example "Claude Code" is often written "cloud code"), so pass likely mis-hearings in also_match. The library is a sample of YouTube, not all of it. Dates are the day we captured the captions, not the day the video was published.

輸入參數limitquery必填sinceuntilchannelalso_match

get_spoken_context

Read what was said around a moment in a video: the sentences before and after a timestamp. Use it after search_spoken_words to see what a matching sentence was part of, before you quote or rely on it. Works for videos in the library only.

輸入參數video必填windowseconds必填

rank_videos_by_topic

Find the videos that talk about something the most, ranked by how many sentences mention it. Better than searching titles when you want the videos that really go deep on a topic. Each result has the number of mentions, the first mention and a link. Read the best ones with get_youtube_transcript or find_in_transcript. Same library, caption quirks and dates as search_spoken_words.

輸入參數limitquery必填sinceuntilchannelalso_match

rank_channels_by_topic

Find which channels talk about something the most, ranked by mentions, with how many of their videos mention it. Use it to find who covers a topic: creators to follow, experts, or partners. Same library, caption quirks and dates as search_spoken_words.

輸入參數limitquery必填sinceuntilalso_match

spoken_mentions_over_time

Count how often something is mentioned over time, by day, week or month. Each period shows the mentions and the rate per million spoken sentences, so busy and quiet periods compare fairly. Use it to see whether a topic is rising or fading. The date is when we captured the captions, not when the video was published, and the first day (2026-09-13) holds a one-off backfill of earlier captions, so compare the rate, not the raw count, and be careful with that first period.

輸入參數query必填sinceuntilbucketchannelalso_match

版本歷史

3
  1. v1.3.0最新Oct 29, 2026
  2. v1.1.0Oct 14, 2026
  3. v1.0.0Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分