概览

AI 生成的概览

让助手通过托管的 YTAPI 端点获取 YouTube 字幕、视频详情、搜索结果、频道上传和播放列表。

功能: 提供 YouTube 数据技能：任意语言的字幕与文字稿，可输出文本、Markdown、带时间戳的 JSON、SRT 或 VTT；视频详情；跨视频、频道、播放列表和 Shorts 的搜索；频道资料与上传列表；播放列表清单；以及视频或频道近期上传的摘要。它是通过 HTTPS 访问的远程 MCP 服务器，无需本地安装，面向直接抓取 YouTube 会失败的场景。
适用场景: 当助手需要 YouTube 字幕、元数据、搜索或频道与播放列表清单时使用，尤其是在服务器或云端代理上直接抓取 YouTube 会遇到限流、机器人检查或 IP 封锁的情况。也适合对视频和频道做摘要与研究。
运行要求: 通过 streamable HTTP 连接 api.ytapi.dev 的远程端点；无需软件包或本地运行时。认证方式为 OAuth 登录 YTAPI 账户，或使用从 YTAPI_API_KEY 环境变量读取的 API 密钥。新账户有 200 个免费额度；付费额度包 2,000 额度起价 9 美元。

安装前请注意

YTAPI_API_KEY 中的 API 密钥属于凭据，应妥善保密。用量按额度计费：每次成功请求消耗一个额度，购买额度包前免费额度限制为每秒 1 次请求、每天 100 次，额度包需要付费。注册时可以把邮箱地址和 6 位验证码交给助手，由助手保存密钥。请求及其返回的数据会发送给第三方服务。

安装

在 SourceWeft 中

打开控制台中的 YTAPI，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "youtube": {
      "type": "http",
      "url": "https://api.ytapi.dev/mcp"
    }
  }
}

README

YouTube skills for AI agents

Agent skills for YouTube transcripts, search, channels and playlists, powered by YTAPI. They work with Claude Code, Codex, Cursor, OpenClaw, Hermes Agent and any agent that reads Agent Skills.

Plain HTTPS calls with curl, nothing else to install. They also work where fetching YouTube directly fails: on servers and cloud agents, tools like yt-dlp often get HTTP 429, a bot check or an IP block.

Install

Claude plugin: the YTAPI MCP server plus skills for video summaries, channel digests and topic research. In Claude Code:

The first time Claude uses a YTAPI tool, run /mcp and sign in to your YTAPI account (or create one: 200 free credits, no card). No API key needed. The plugin lives in plugins/ytapi.

Claude Code, Codex, Cursor, Cline and others (skills.sh):

One skill only:

OpenClaw (ClawHub):

Hermes Agent:

Not a developer? Paste this to your agent:

Install the YouTube skill from https://github.com/ytapi/youtube-skills and set up my YTAPI key.

Skills

Skill	What it does
`ytapi`	Everything below in one skill: transcripts, video details, search, channels, playlists, batches
`ytapi-youtube-transcript`	Transcripts and subtitles: text, Markdown, timestamped JSON, SRT, VTT, any language
`ytapi-youtube-search`	Search videos, channels, playlists and Shorts, then read the results
`ytapi-youtube-channels`	Channel profiles, latest uploads, all videos, playlists
`ytapi-youtube-summarize`	Summaries and notes of a video or a channel's new uploads, with timestamped links

Install ytapi if you are unsure.

API key

The skills read the key from YTAPI_API_KEY. If it is not set, the agent offers to create a free account for you: you give it your email address and the 6-digit code we send you, and it stores the key. No browser and no card. Or create a key yourself at ytapi.dev.

New accounts get 200 free credits. One successful request uses one credit (video basic info and search suggestions are free); failed requests are free. Until you buy a credit pack, a key can make 1 request per second and 100 per day. Packs start at $9 for 2,000 credits and never expire: pricing.

Examples

"Summarize this video: https://youtu.be/dQw4w9WgXcQ"
"Get the Spanish subtitles of this talk as an SRT file."
"Find this week's most-viewed videos about Rust async and tell me what they cover."
"What has @mkbhd uploaded lately? Give me a two-line summary of each."
"List every video in this playlist with its length."

Links

Docs: https://docs.ytapi.dev (for agents: https://docs.ytapi.dev/llms-full.txt)
Remote MCP server: https://docs.ytapi.dev/agent-setup/#mcp
Agent sign-up API: https://docs.ytapi.dev/agent-signup/
Support: [email protected]

Contributing

Each skill carries a copy of shared/auth-setup.md in its references/ folder, because skills are installed one at a time. Edit the file in shared/, then run ./scripts/sync-references.sh.

The Claude plugin in plugins/ytapi has its own skills, which use the MCP tools and never handle an API key. When you change them, bump version in plugins/ytapi/.claude-plugin/plugin.json: Claude Code keeps plugin users on the version listed there.

Licensed MIT-0.

来源：README.md，提交 5af959c

工具

0

工具元数据尚未被收录。

版本历史

1

v1.0.0最新Oct 8, 2026

YTAPI

概览

安装