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 分