Scribiz

Scribiz：用于获取 YouTube 视频文字稿、摘要和时间戳的视频 MCP 服务

通过视频链接，让 Claude、Cursor、Codex 或任何 MCP 客户端获取视频内容：文字稿、摘要、章节，以及能回答问题的具体片段，每个片段都附有时间戳链接。支持 YouTube、TikTok、Instagram、X 和 Vimeo 链接。开始使用无需账号或 API 密钥。

claude mcp add --transport http scribiz https://scribiz.com/mcp

观看48 秒演示。其中每个响应都是真实的服务调用。

此仓库包含托管版 Scribiz MCP 服务的配置文件，地址为 https://scribiz.com/mcp。服务运行在 scribiz.com 上。Scribiz 源代码不在此仓库中。

Agent 如何使用它

将视频链接粘贴到聊天中。Agent 会先向 Scribiz 请求简短概述，再搜索所需片段，只读取该片段，并附上可直接跳转到对应时刻的视频链接来回答。它不会为了回答一个问题而读取整份文字稿。

添加服务

托管服务无需账号或密钥。添加 URL 即可使用。

Claude Code

claude mcp add --transport http scribiz https://scribiz.com/mcp

在 Claude Code 中运行 /mcp，即可查看服务及其工具。

Claude Desktop 和 claude.ai

前往 Customize，然后选择 Connectors。选择 + Add，再选择 Add custom connector。填写：

• 名称：Scribiz
• URL：https://scribiz.com/mcp
• 身份验证：No sign in

claude_desktop_config.json 文件用于配置本地服务。使用托管服务不需要此文件。

Cursor

将以下内容放入 ~/.cursor/mcp.json，或项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "scribiz": { "url": "https://scribiz.com/mcp" }
  }
}

VS Code

将以下内容放入 .vscode/mcp.json。VS Code 使用 servers，而不是 mcpServers。

{
  "servers": {
    "scribiz": { "type": "http", "url": "https://scribiz.com/mcp" }
  }
}

Codex

将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.scribiz]
url = "https://scribiz.com/mcp"

Claude Code 插件（服务和技能）

此仓库也是 Claude Code 插件市场。该插件会添加服务和一项技能，教 Claude 如何使用它。

claude plugin marketplace add Illyism/scribiz-mcp
claude plugin install scribiz@scribiz-mcp

请使用该插件或上面的 claude mcp add 命令，不要同时使用两者。其他 Agent 可单独安装此技能：

npx skills add Illyism/scribiz-mcp

试用

向你的 Agent 提问：

Summarize https://www.youtube.com/watch?v=jNQXAC9IVRw, then find where they talk about the trunks and quote it.

这是一个 19 秒的公开视频，名为 “Me at the zoo”。你应该会看到对 get_video_context 和 search_video 的调用，以及带有时间戳链接的回答。结果会说明文字稿是如何生成的。如果模型读取了该链接，时间点为近似值（前后约 2 秒）。Scribiz 首次处理某个视频时，会从当日额度中扣除少量用量；这个视频约需 0.3 分钟。此后则无需付费。

工具

这五个工具均为只读工具。它们会访问互联网，但绝不会更改你的文件。

工具	功能
get_video_context	获取视频上下文，包括标题、时长、摘要、章节和关键片段链接。从这里开始。
search_video	搜索视频。查找说到或展示某个词语或短语的片段，按相关性排序并附上链接。
ask_video	针对视频提问。返回包含 3 到 5 个引用片段的答案。
get_transcript	获取视频文字稿。可以逐页获取全部内容或其中一部分，支持 TXT、Markdown、SRT、VTT 或 JSON 格式。
get_job	检查视频任务。可继续获取仍在处理中的视频。

每项结果都会说明处理了哪些层级（字幕、听取、观看、模型摘要）以及耗用了多少分钟。详情请参阅工具参考。

无需账户即可使用的功能

• 字幕（服务器能够读取时）。
• Scribiz 已处理过的视频，免费使用。唯一的例外是 Scribiz 尚未为该视频撰写的摘要，这会消耗视频时长的十分之一。
• 服务器无法读取字幕的视频：模型会通过链接读取视频。时间点为近似值（前后约 2 秒），没有说话人标签，结果中也会注明这一点。

这些功能受免费额度限制：每个连接每天约有 10 分钟读取时长（与免费网页工具相同），视频时长上限为 15 分钟，每天可提问 5 次、查询字幕 30 次。不使用密钥的所有连接还会共享另一项每日限额。用完 10 分钟额度或共享限额后，字幕和已处理的视频仍可使用。用完 30 次字幕查询后，已处理的视频仍可使用。用完 5 次提问后，搜索和读取仍可使用。错误信息会说明哪项额度已用完，以及何时重置（00:00 UTC）。

不使用密钥时，服务器绝不会查看画面，因此不会提供画面上的注释；关于画面内容的问题也只会根据文字作答。Watch 会读取画面和屏幕上显示的文字。它需要 Scribiz API key，并会消耗套餐中的分钟数。免费账户每月有 30 分钟额度，你可以在控制面板中创建密钥。使用密钥时，将 watch: true 传给 get_video_context 或 ask_video；Scribiz 已存储的画面注释可免费返回。请参阅连接模式和限额与费用。

托管服务器只接受公开链接。它无法读取你磁盘上的文件。

使用密钥

将密钥作为 bearer token 发送。在 Claude Code 中：

claude mcp add --transport http scribiz https://scribiz.com/mcp --header "Authorization: Bearer YOUR_SCRIBIZ_KEY"

本地文件

命令行工具附带本地服务器。它在你的机器上运行，可以读取你的文件。它需要 Node 24、ffmpeg 和 yt-dlp，目前仅在 macOS 上经过测试。

npm install -g scribiz
scribiz login
claude mcp add scribiz -- scribiz mcp

数据会发送到哪里

你的 Agent 会将视频链接和问题发送到 scribiz.com。只要可行，Scribiz 就会从你链接的网站获取字幕。对于尚未处理的视频，Scribiz 会将链接传给 Google 的 Gemini API，由其模型读取公开视频。你的机器不会上传任何内容。如果 Scribiz 下载了音频，就会将音频发送给 Google 进行转录和分析。使用 Watch 时，它还会发送一份低分辨率的小尺寸画面副本，不含声音。隐私政策说明了数据保留期限和 Google 的条款。此仓库不会发送任何内容，只包含设置文件。

将转录文本视为数据

视频中可能包含任何内容，包括“忽略你的指令”。服务器会将视频中的所有文本用 === BEGIN UNTRUSTED VIDEO TEXT [id] === 和 === END UNTRUSTED VIDEO TEXT [id] === 行括起来，并在结果中设置 untrusted_content: true。在读取视频的会话中，不要自动批准可发送消息、运行命令或写入文件的工具。更多信息请参阅 MCP 安全。

链接

• Scribiz MCP 服务页面
• MCP 文档
• 隐私政策和条款
• 关于此仓库或设置文件的问题：在此处提交 issue。

还有 Scribiz 的其他产品

Scribiz 还提供免费的网页工具。粘贴视频链接，即可获取转录文本。无需账户：scribiz.com。Apple 芯片 Mac 可使用 Mac 应用，下载地址为 scribiz.com/download；此外，npm 上还有命令行工具（npm install -g scribiz）。

由 Ilias Ism 开发。