Scribefy

scribefy-mcp

MCP 服务，适用于 Scribefy——可在 Claude Desktop、Cursor、Windsurf、ChatGPT 自定义 GPT 或任何其他兼容 MCP 的客户端中提取 YouTube 字幕稿。

现已上线——按照下方说明，一分钟即可完成设置；也可以试试 Web 应用 scribefy.app。

为什么

大多数 YouTube 字幕稿工具都以浏览器扩展或一次性 Web 界面的形式提供。本工具将 Scribefy 的 API 封装为 MCP 标准，让 AI 助手可以在用户粘贴 YouTube 链接时随时获取字幕稿——无需手动复制粘贴，也无需打开单独的标签页。

要求

• Node 20+
• 需要拥有 Scribefy API + MCP 套餐（$25/mo）的账号以获取 API 密钥。你可以先不配置密钥，直接安装——MCP 宿主会正常注册服务，你尝试使用工具时会收到友好的提示——然后从 scribefy.app/dashboard 添加密钥，即可开始提取。

设置

Claude Desktop

打开配置文件（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "scribefy": {
      "command": "npx",
      "args": ["-y", "scribefy-mcp"],
      "env": {
        "SCRIBEFY_API_KEY": "sk_live_…"
      }
    }
  }
}

重启 Claude Desktop。extract_transcript 工具会显示在可用工具面板中。

Cursor

Settings → Cursor Settings → MCP → Add new MCP server：

{
  "scribefy": {
    "command": "npx",
    "args": ["-y", "scribefy-mcp"],
    "env": {
      "SCRIBEFY_API_KEY": "sk_live_…"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "scribefy": {
      "command": "npx",
      "args": ["-y", "scribefy-mcp"],
      "env": {
        "SCRIBEFY_API_KEY": "sk_live_…"
      }
    }
  }
}

其他客户端

任何支持 stdio 传输的 MCP 宿主：在环境变量中设置 SCRIBEFY_API_KEY，并启动 npx -y scribefy-mcp。该服务通过 stdin/stdout 使用标准的 MCP JSON-RPC 协议进行通信。

提供的工具

共四个工具。其中三个免费（研究工具包）；只有 extract_transcript 会消耗额度。

extract_transcript

提取 YouTube 视频的字幕稿。

参数	类型	必填	说明
url	string	是	完整的 YouTube URL——youtube.com/watch?v=…、youtu.be/… 或 youtube.com/shorts/…
lang	string	否	BCP-47 语言代码（例如 en、es、fr、zh-Hans）。默认为 en

返回： Markdown，包含标题、频道、时长、语言，以及按时间戳拆分的字幕稿。

费用： 1 个额度（≤15 min）→ 8 个额度（2 h+）。缓存的字幕稿免费。

search_videos

按文本搜索 YouTube 视频。

参数	类型	必填	说明
query	string	是	搜索词——语法与 YouTube 自带搜索栏接受的语法相同
limit	number	否	结果数量上限，1–25（默认 10）

返回： Markdown 列表，列出每个结果的标题 / 频道 / 时长 / 观看次数 / URL。

费用： 免费。

get_video_metadata

获取标题、频道、时长、观看次数、上传日期和可用的字幕轨道。不会提取字幕稿。

参数	类型	必填	说明
url	string	是	完整的 YouTube URL

返回： Markdown 摘要，以及所有字幕轨道的列表（人工制作 ✏ 或自动生成 ⚙），并附带语言代码。

费用： 免费。可用此工具在决定是否提取字幕稿前检查视频，或查看有哪些字幕语言可用。

get_related_videos

获取 YouTube 视频的“接下来播放”推荐内容。

参数	类型	必填	说明
url	string	是	种子视频的完整 YouTube URL
limit	number	否	相关视频数量上限，1–25（默认 10）

返回： 格式与 search_videos 相同。

费用： 免费。

未来版本中推出的工具

list_channel_videos 和 get_video_comments 原计划在 0.3.0 版本推出，但由于我们正在等待上游 youtubei.js 发布针对 YouTube 2026 年响应结构变更的修复，因此推迟到 0.4.0 版本。频道列表功能在 InnerTube 层会返回 HTTP 400，而 info.getComments() 不再附加到已解析的 VideoInfo 上。等该库完成适配后，这两个工具就会重新推出。

技能

此仓库附带一个 Agent 技能（助手按需加载的 SKILL.md），用于教会它如何更好地使用这些工具——先用免费工具筛选候选内容，再消耗额度；优先使用作者提供的字幕；充分利用免费的转录缓存；并在答案中引用时间戳。

• skills/youtube-research — YouTube 研究工作流：搜索 → 筛选元数据 → 有选择地提取 → 综合并使用 [mm:ss] 引用。

若要在 Claude Code 中使用，请将该文件夹复制到项目的 .claude/skills/（或复制到 ~/.claude/skills/，以便全局使用）。兼容 Plugins 的宿主可直接从仓库中检测到它。

配置

环境变量	必需	默认值	备注
SCRIBEFY_API_KEY	是	—	sk_live_…（生产环境）或 sk_test_…（Scribefy 测试模式）
SCRIBEFY_API_BASE	否	https://api.scribefy.app	覆盖为预发布环境（https://api-staging.scribefy.app）或自托管实例

故障排除

SCRIBEFY_API_KEY is required 确保在 MCP 宿主的配置中设置了 env 块，并且宿主确实加载了它。某些宿主默认会移除环境变量——请查看其文档。

Scribefy rejected the API key 可能是密钥错误、密钥已撤销，或你的订阅不再包含 API + MCP 方案。请查看 scribefy.app/dashboard。

Not enough credits 工具会在错误消息中返回剩余额度和费用。请前往 scribefy.app/pricing 充值。

我的 MCP 客户端中没有显示该工具 编辑配置后，请彻底重启客户端（而不只是聊天窗口）。如果可以，请查看客户端日志——大多数客户端会在其中显示 MCP 标准错误输出。服务启动后会打印 scribefy-mcp: ready。

许可证

MIT