关于 rippr
rippr 为用户和 AI Agent 提取 YouTube 字幕,提供网站、Chrome 扩展和本地 MCP 服务。它支持纯文本、结构化 JSON 和 Markdown,并采用多种提取方式。
主要功能
- 01提取 YouTube 字幕
- 02输出纯文本、JSON 或 Markdown
- 03通过网站或 Chrome 扩展使用
- 04将 MCP 字幕保存到本地目录
- 05采用多种提取策略
适用场景
- 01从 YouTube URL 获取字幕
- 02浏览 YouTube 页面时提取字幕
- 03准备适合切分和嵌入的字幕文本
- 04向 AI 客户端提供带时间戳的字幕数据
MCP 相关
本地 stdio MCP 服务连接兼容的桌面客户端,并返回已保存字幕的文件路径。字幕存储在 `~/rippr/transcripts/`。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
1收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | YouTube 视频 URL。支持任何 YouTube URL 格式(watch、youtu.be、embed、shorts 或 11 位纯 ID)。 |
| format | enum | 否 | 保存的文件格式。'text' 会写入带 YAML frontmatter 和连续字幕块的 Markdown 文件(最适合 RAG/LLM)。'segments' 会写入带时间戳片段的 JSON 文件(最适合章节标记和精确引用)。默认值:text。text | segments |
| save_path | string | 否 | 可选的字幕保存位置覆盖值。可以是绝对路径、~/-相对路径、目录(文件名自动生成)或完整文件路径。保存到默认目录之外时,返回的 resource_link 仍指向已保存的文件,以便之后读取。默认值:~/rippr/transcripts/<slug>_<videoId>.<ext> |
| return_text | boolean | 否 | 为 true 时,在工具响应中通过 resource_link 同时包含完整字幕文本。默认值:false。仅对短视频片段或用户明确要求内联字幕时使用 true。 |
详细介绍
rippr
为人类和 AI Agent 提取 YouTube 字幕文本。
网站 · Chrome 网上应用店 · MCP 服务(npm)
使用 rippr 的三种方式
🌐 网站 — rippr.me
粘贴 YouTube URL,即可获取字幕文本。文本整洁,无需注册。
🧩 Chrome 扩展程序 — Chrome 网上应用店
在任意 YouTube 页面上一键提取字幕文本。支持多种输出格式(RAG、JSON、Markdown)。
🤖 MCP 服务 — npm
将 rippr 连接到 Claude、Cursor 或任何兼容 MCP 的客户端。每份字幕文本都会保存到 ~/rippr/transcripts/,并将文件路径返回给模型。
仅适用于桌面客户端。 rippr 以本地 stdio 进程运行,因此可与 Claude Desktop、Claude Code CLI 和 Cursor 配合使用。它无法与云端托管的客户端配合使用(网页上的 claude.ai、Claude 手机应用,或手机/网页端的 Claude Code),因为这些客户端无法启动本地进程。
npx rippr-mcp
添加到 Claude Desktop(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"rippr": {
"command": "npx",
"args": ["-y", "rippr-mcp"]
}
}
}
然后询问:“提取这个 YouTube 视频的字幕文本:[url]”。有关完整的工具列表,请参阅 mcp/README.md。
输出格式
- RAG (.txt) — 单个连续文本块,针对分块和嵌入进行了优化
- 结构化 (.json) — 带时间戳的片段及元数据
- 易读 (.md) — 带标题和格式的 Markdown
工作原理
采用多策略提取,确保最大可靠性:
- Innertube API — YouTube 的内部播放器 API(Android 客户端)
- HTML 抓取 — 从页面源代码解析
ytInitialPlayerResponse - 字幕面板 — 作为最后手段,打开 YouTube 内置的字幕面板
支持以多种格式解析字幕 XML(srv3、timedtext、JSON3)。遇到暂时性故障时,会通过指数退避策略重试。
隐私
完全在你的设备上运行。不会向外部服务发送数据。无需账户,不跟踪用户。仅与 YouTube 自身的 API 通信。
更多 MCP
| MCP | 功能 |
|---|---|
| Japan UX | 面向 AI 的日式 UX 规则:表单、敬语、排版、信任信号 |
| Rakuten | 搜索乐天的市场、图书和酒店 |
| Xendit | Xendit 支付 API:发票、付款、余额 |
免责声明
Rippr 是一款非官方的社区开发工具。它与 YouTube 或 Google LLC 无关,也未获得其认可或赞助。YouTube 是 Google LLC 的商标。
Rippr 通过 YouTube 自有应用使用的端点访问公开的 YouTube 字幕数据。使用本工具须遵守 YouTube 的服务条款,风险由您自行承担。对于因使用本工具而导致的下架、速率限制、账号处置或任何其他后果,作者概不负责。
如果 YouTube 更改其内部 API,导致无法提取数据,本工具可能会在不另行通知的情况下停止工作。如需长期用于生产环境,请考虑使用官方的 YouTube Data API v3 和 API 密钥(此软件包目前不支持)。
许可证
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。