TranscriptAPI MCP-随时随地获取YouTube成绩单
> 用于Claude、ChatGPT、Cursor和20多个AI工具的生产级YouTube转录提取。
> 每天处理20多万份成绩单。受到YouTubeToTranscript.com和Recapio.com的信任。
❌ 无转录API
- ❌ 从YouTube笨拙的成绩单用户界面手动复制粘贴
- ❌ 人工智能对话期间无法访问成绩单
- ❌ 浏览器选项卡之间的上下文切换浪费时间
- ❌ 无法有效分析或比较多个视频
- ❌ 自行制造刮刀不可靠,经常损坏
✅ 使用TranscriptAPI
- ✅ 粘贴任何YouTube网址,获取即时成绩单
- ✅ 在您的AI工作流程中无缝工作
- ✅ 并排比较多个视频
- ✅ 生产级可靠性,每日成绩单超过20万份
快速演示:```txt
Summarize the key points from this video:
https://www.youtube.com/watch?v=dQw4w9WgXcQ
TranscriptAPI会自动获取成绩单,您的AI会立即对其进行分析。
## 两条整合路径
|| MCP集成| REST API|
| --------------- | ------------------------------------ | --------------------------------------------------------- |
| **最适合** |人工智能助手和聊天界面|开发人员和应用程序|
| **设置** |零代码,只需添加URL |需要代码集成|
| **交互** |自然语言查询|程序化JSON请求|
| **开始使用** | 安装指南 | API文档→ |
> **构建应用程序?** 我们的REST API通过JSON响应、时间戳和元数据为您提供完整的编程控制。
> 基本URL: `https://transcriptapi.com/api/v2` | 查看Swagger用户界面→
## 🛠️ 安装
> **要求:**
>
> - TranscriptAPI帐户(免费注册)
> - API密钥来自 仪表盘 或OAuth(适用于Claude/ChatGPT)
> **推荐:向自动调用TranscriptAPI添加规则**
>
> 将此规则添加到您的AI客户端,这样您就不需要明确要求提供成绩单:
>
>```txt
> When I share a YouTube URL, automatically use the TranscriptAPI MCP tool
> to fetch the transcript before responding. This applies to any video analysis,
> summarization, or question about YouTube content.
> ```
Install in Cursor (One-Click / Manual)
**一键安装:**
**手动配置:**
首选 `Settings` -> `Features` -> `MCP` -> `Add New MCP Server`
- **姓名:** `transcript-api`
- **类型:** `SSE` (远程)
- **网址:** `https://transcriptapi.com/mcp`
或编辑 `~/.cursor/mcp.json`:```json
{
"mcpServers": {
"transcript-api": {
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in Claude (Desktop & Web) - Recommended
Claude现在支持通过“自定义连接器”UI直接添加MCP服务器。
快速设置:
- 打开克劳德设置(单击您的个人资料图标->设置)
- 首选 连接器 -> 添加自定义连接器
- 输入以下详细信息:
- 姓名:TranscriptAPI
- 网址:https://transcriptapi.com/mcp - 点击 添加,然后单击 连接 通过浏览器授权。
- (可选)在连接器设置中,将权限更改为“允许无监督”,以实现无缝使用。
完整指南:
有关截图的全面演练,请阅读我们的 官方克劳德集成指南.
Install in Claude Code (CLI)
在终端中运行以下命令:```sh
claude mcp add --transport http transcript-api https://transcriptapi.com/mcp
Install in ChatGPT (OAuth)
ChatGPT支持OAuth进行安全身份验证。您需要启用 **开发人员模式** 首先在ChatGPT设置中。
**快速设置(凭据可选):**
1. 在ChatGPT中,转到 `Settings` -> `Connected Apps` -> `Add`
1. 输入MCP服务器URL: `https://transcriptapi.com/mcp`
1. **客户端ID和密码是可选的:**
- **把它们留空** 使用动态客户端注册(推荐/更简单)。ChatGPT将自动注册。
- **(高级)** 或者从您的帐户中输入客户ID和密码 仪表盘 如果你更喜欢静态注册。
1. 点击 **添加** 并通过浏览器弹出窗口进行授权。
**完整指南:**
有关启用开发人员模式、添加连接器和授权的分步教程,请阅读我们的 官方ChatGPT集成指南.
Install in VS Code
将此添加到您的VS Code用户设置中(`settings.json`):```json
"mcp.servers": {
"transcript-api": {
"type": "http",
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
Install in Windsurf
将此添加到您的Windsurf MCP配置中(~/.codeium/windsurf/mcp_config.json):```json
{
"mcpServers": {
"transcript-api": {
"serverUrl": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in OpenAI Agent Builder
OpenAI代理生成器当前需要API密钥身份验证(还不支持OAuth)。
1. 创建新代理
1. 在“操作”或“工具”下,添加新的 **MCP服务器**
1. 网址: `https://transcriptapi.com/mcp`
1. 身份验证类型: **API密钥**
1. 从粘贴您的API密钥 仪表盘
查看分步指南→
Install in Cline
添加到您的Cline MCP设置中:```json
{
"mcpServers": {
"transcript-api": {
"url": "https://transcriptapi.com/mcp",
"type": "streamableHttp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in Zed
添加到您的Zed settings.json:```json
{
"context_servers": {
"transcript-api": {
"source": "remote",
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in Roo Code
添加到您的Roo代码配置中:```json
{
"mcpServers": {
"transcript-api": {
"type": "streamable-http",
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in Amp
通过CLI运行:```sh
amp mcp add transcript-api https://transcriptapi.com/mcp --header "Authorization: Bearer YOUR_API_KEY"
Install in Augment Code
在 `settings.json` 在...之下 `augment.advanced`:```json
"augment.advanced": {
"mcpServers": [
{
"name": "transcript-api",
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
]
}
Install in Kilo Code
在 .kilocode/mcp.json:```json
{
"mcpServers": {
"transcript-api": {
"type": "streamable-http",
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in JetBrains AI Assistant
在“设置”->“工具”->“AI助手”->“MCP”中:```json
{
"mcpServers": {
"transcript-api": {
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in Gemini CLI
在 ~/.gemini/settings.json:```json
{
"mcpServers": {
"transcript-api": {
"httpUrl": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in Qwen Coder
在 `~/.qwen/settings.json`:```json
{
"mcpServers": {
"transcript-api": {
"httpUrl": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in Google Antigravity```json
{
"mcpServers": {
"transcript-api": {
"serverUrl": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in Trae```json
{
"mcpServers": {
"transcript-api": {
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in LM Studio
在 mcp.json:```json
{
"mcpServers": {
"transcript-api": {
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in BoltAI
在插件->JSON配置中:```json
{
"mcpServers": {
"transcript-api": {
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Install in Warp
在设置->AI->MCP中:```json
{
"transcript-api": {
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
Install in Perplexity Desktop
在“设置”->“连接器”->“高级”中:```json
{
"url": "https://transcriptapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
🔐 认证
API密钥验证
简单而通用。适用于每个MCP客户端。
- 从获取API密钥 仪表盘
- 按键以开头
sk_前缀 - 添加到配置中作为承载令牌:```json
"headers": {
"Authorization": "Bearer sk_your_api_key_here"
}
> **安全说明:** 尽可能将密钥存储在环境变量中,并且永远不要将其提交给版本控制。
### OAuth身份验证
自动、安全的身份验证,无需手动密钥管理。
**动态客户端注册(DCR):**
- 支持:克劳德桌面,ChatGPT
- 只需添加MCP URL-客户端自动注册
- 无需凭据
- 您将通过浏览器重定向授权一次
**静态客户端注册:**
- 支持:ChatGPT(可选/某些设置需要)
- 从获取客户端ID+密码 MCP集成仪表板
- 对客户身份的更多控制
## 🧰 可用工具
### `get_youtube_transcript`
获取给定YouTube视频的文字记录。
|参数|类型|默认值|说明|
| ------------------- | ------- | ------------ | ---------------------------------------------- |
| `video_url` |字符串| **必需的** |YouTube URL(完整、简短)或11个字符的视频ID|
| `send_metadata` |布尔值| `true` |包括视频标题、作者、缩略图|
| `format` |字符串| `"text"` |输出格式: `"text"` (降价)或 `"json"` |
| `include_timestamp` |布尔值| `true` |为每个片段添加时间戳|
**示例输出(文本):**```markdown
# Metadata
## Title: Rick Astley - Never Gonna Give You Up
## Author: RickAstleyVEVO
# Transcript
[0.0s] Never gonna give you up
[4.12s] Never gonna let you down
示例输出(JSON):json
{
"transcript": [
{ "text": "Never gonna give you up", "start": 0.0, "duration": 4.12 },
{ "text": "Never gonna let you down", "start": 4.12, "duration": 3.85 }
],
"metadata": { "title": "Rick Astley...", "author_name": "RickAstleyVEVO" }
}
💡 使用案例和提示
| 用例 | 示例提示 |
|---|---|
| 📝 摘要 | “总结此视频的要点:[URL]” |
| 🔍 研究 | “[URL]中提出的主要论点是什么?” |
| 📚 学习精要 | “根据本次讲座创建学习笔记:[URL]” |
| ⚖️ 比较 | “比较这两个视频中的视角:[URL1][URL2]” |
| ✍️ 内容再利用 | “将此视频转换为博客文章:[URL]” |
💳 定价和费率限制
| 计划 | 价格 | 积分 | 利率限制 |
|---|---|---|---|
| 自由 | $0/月 | 100 | 60需求/分钟 |
| 启动器 | 每月5美元 | 1000 | 200需求/分钟 |
- 1学分 =1个成功请求(HTTP 200)
- 失败的请求或速率受限的请求不会消耗积分。
- 查看价格 | 管理积分
🚨 故障排除
Authentication Errors (401)
- 验证您的API密钥以
sk_ - 复制时检查是否有多余的空格
- 确保密钥在您的 仪表盘
- 如果使用OAuth,请尝试重新授权
No Credits (402)
- 请在以下网址查看您的信用余额 仪表盘
- 购买更多积分或升级您的计划
Video Not Available (404)
- 视频可能未启用字幕/字幕
- 视频可能是私人的或受年龄限制的
- 视频可能被区域锁定
Rate Limiting (429)
- 尊重
Retry-After头球 - 在客户机中实现指数回退
- 升级到付费计划以获得更高的限额
OAuth Issues
- 清除浏览器Cookie,然后重试
- 对于ChatGPT,尝试在动态和静态注册之间切换
- 确保弹出窗口阻止程序不会阻止身份验证窗口
🤝 联系我们
- 🌐 网站: transcriptapi.com
- 📚 文档: transcriptapi.com/docs
- 🔧 API参考: transcriptapi.com/docs/api
- 💬 联系人: transcriptapi.com/contact
©2025零点工作室版权所有。
