ReelScribe

ReelScribe MCP 服务

一个 MCP（Model Context Protocol） 服务，可将 AI 助手连接到 ReelScribe，让你直接通过 Claude、Cursor、Windsurf 和其他兼容 MCP 的客户端转录 Instagram Reels、TikTok 视频和 YouTube 视频。

设置

托管连接器（Cloudflare Workers）

端点为 https://reelscribe.app/api/mcp。将其添加为 Claude 中的远程 连接器，或添加为 ChatGPT 开发者模式中的 MCP 连接，然后 登录 ReelScribe 账户并批准访问权限。目录发布需要经过单独的审核流程。

托管转录会立即返回 requestId。处理完成后，使用 get_transcription 和该 ID 获取转录内容；重复提交会返回已有转录内容。账户管理可在网站上进行。

部署

1. 部署配套的 ReelScribe API OAuth 变更，包括 /admin/get-user-by-clerk-id 上的 Convex includeRetention 响应。
2. 在生产 Clerk 实例中，创建并发布自定义范围 reelscribe:mcp，其同意说明应解释：该权限可读取转录内容和 额度余额，以及提交会消耗额度的转录任务。启用 CIMD 客户端接入，要求使用 S256 PKCE，并将默认范围设置为 reelscribe:mcp。如需扩展工作流，请注册单独的可选范围 reelscribe:manage，并为兼容性保留其现有名称。 该范围的同意说明必须仅说明会消耗额度的批量／频道提交。 默认范围为 reelscribe:mcp reelscribe:manage；单视频客户端可以 只请求 reelscribe:mcp。现有连接重新连接时，必须明确批准额外的 转录权限。保持启用不透明访问令牌。允许目标 客户端请求自定义范围；仅为需要 DCR 的客户端启用 DCR。
3. 使用具有 SIÁN 账户中 Workers 部署权限的凭据验证 Wrangler。 如果 Wrangler 列出多个账户，请将 CLOUDFLARE_ACCOUNT_ID 设置为对应账户。
4. 依次运行 bun run typecheck、bun test、bun run worker:build，然后 运行 bun run worker:deploy。
5. 验证 /health、公开 OAuth 元数据、未经身份验证时 /mcp 返回的 401 挑战，以及两个客户端中的完整登录和转录流程。

ReelScribe 网站会将品牌化 URL 转发到现有的 Cloudflare Worker，并附带 branded=1，该参数会选择匹配的 OAuth 资源元数据。 原始的 https://reelscribe-mcp.sian-agency.workers.dev/mcp 端点及其 OAuth 发现机制仍可供现有连接使用。该域名由 Cloudflare 之外的服务管理，因此若要直接使用 Worker 自定义子域名，则需要更改 DNS。

Worker 不持有共享的用户 API 密钥或 Clerk 密钥。它会将每位 调用者的令牌转发给 ReelScribe API，由该 API 使用 Clerk 验证令牌，并且只解析该令牌对应的用户。基础 OAuth 范围允许读取转录内容、额度和任务，并提交单视频转录。 批量／频道提交需要单独授予 reelscribe:manage 权限。尽管该范围沿用了旧名称，它仅授予提交转录任务的权限。 即使已有管理权限，也无法访问下载、删除、分析或设置功能。

下方仍提供本地 stdio 设置方法。

1. 获取 API 密钥

在 reelscribe.app 注册（可获 25 个免费额度），并从 API 设置生成 API 密钥。

2. 配置 MCP 客户端

将以下内容添加到 MCP 客户端配置中：

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "reelscribe": {
      "command": "npx",
      "args": ["-y", "reelscribe-mcp-server"],
      "env": {
        "REELSCRIBE_API_KEY": "rs_your_api_key_here"
      }
    }
  }
}

Claude Code（~/.claude.json 或项目 .mcp.json）：

{
  "mcpServers": {
    "reelscribe": {
      "command": "npx",
      "args": ["-y", "reelscribe-mcp-server"],
      "env": {
        "REELSCRIBE_API_KEY": "rs_your_api_key_here"
      }
    }
  }
}

Cursor（设置 > MCP）：

{
  "mcpServers": {
    "reelscribe": {
      "command": "npx",
      "args": ["-y", "reelscribe-mcp-server"],
      "env": {
        "REELSCRIBE_API_KEY": "rs_your_api_key_here"
      }
    }
  }
}

可用工具

工具	描述
transcribe_video	提交视频 URL（1 个点数）。Instagram、TikTok 和 YouTube 可选使用 includeComments。托管服务会返回任务 ID；本地服务会等待结果。
get_transcription	通过 ID 或 requestId 获取转录内容。返回完整的转录文本。
list_transcriptions	列出一页转录内容（默认 20 条，最多 200 条），按时间从新到旧排列。支持按状态、平台、创作者、日期、任务和请求进行筛选。
search_transcriptions	在限定的近期时间范围内，通过原视频 URL 查找转录内容。
get_credits	查看点数余额、订阅等级、已存储的转录数量和保留期限。
validate_url	检查 URL 是否受支持，无需提交。

| transcribe_bulk | 提交 URL 列表（包括从 CSV 读取的 URL）；受等级限制，每个新视频需 1 个点数。 | | transcribe_instagram_channel | 付费的 Instagram 频道抓取，每次处理 1–50 个 Reels，可选日期筛选。 | | list_jobs | 查看进度，并翻页浏览自己拥有的批量/频道任务。 |

这九种工具专注于转录。下载、资料库管理、重试、取消、分析、设置和账单功能可在 Web 应用中使用。批量和频道提交需要 API 密钥或明确授予额外的 reelscribe:manage 转录许可；旧版仅包含基础权限的 OAuth 令牌无法执行这些操作。暂不支持 Facebook 评论。托管版 2.2.1 尚未发布延期的 npm 版本。

评论提取

在 transcribe_video 中设置 includeComments: true，即可在转录新的 Instagram、TikTok 或 YouTube 视频时一并获取部分热门评论。该选项默认关闭，总费用仍为 1 个点数。如有可用数据，会优先选择置顶评论和创作者评论；YouTube 不会提供置顶标记。不支持提取 Facebook 评论。此功能不会导出完整评论串。

已完成的结果包含一个 comments 数组，其中有 text、author、likes、isPinned 和 isCreator；未返回评论时，该数组为 null。stats.comments 是视频的评论总数，与数组中的评论条目分开。若已有匹配的转录内容，则会直接复用，不会添加新评论。

{ "url": "https://www.youtube.com/watch?v=vXUPEow4Itw", "includeComments": true }

分页

list_transcriptions 返回一页内容，而非整个资料库。只要 hasMore 为 true，就将 nextCursor 作为 cursor 传回，以继续浏览剩余内容。

API 不会报告资料库总数，因此此服务不会虚构该数字：只有在响应可确切证明覆盖整个结果集时（第一页且没有后续页面），libraryTotal 才会是一个数字，否则为 null。如需整个资料库的数量，可通过 get_credits 查看 library.completedTranscriptions；该数量本身也有上限，实际数量更高时会通过 library.isCapped 标明。

列表结果中的转录文本是 500 个字符的预览，完整长度显示在 transcriptChars 中；如需读取完整内容，请使用 ID 调用 get_transcription。

存储与保留期限

没有存储配额。各等级的数量限制已于 2026-07-31 取消——资料库改为按时间限制，get_credits 会报告适用于该账户的保留期限（订阅期间为 unlimited，否则为滚动时间窗口）。政策日期之前创建的转录内容绝不会自动删除。

支持的平台

• Instagram — Reels、帖子（/p/）、IGTV（/tv/）
• TikTok — 视频、短链接（vm.tiktok.com、vt.tiktok.com）
• YouTube — 视频、Shorts、短链接（youtu.be）
• Facebook — 视频（/watch?v=、/videos/）、Reels、短链接（fb.watch）

使用示例

“转录这个 TikTok 视频：https://www.tiktok.com/@user/video/123456”

“查看我的点数余额”

“列出我已完成的转录内容”

“我之前转录过这个视频吗？https://www.instagram.com/reel/ABC123/”

定价

• 免费版：注册即获 25 个点数
• 创作者版：$9.99/月 — 1,000 个点数
• 代理商版：$24.99/月 — 3,000 个点数
• 企业版：$59.99/月 — 10,000 个点数

每次转录消耗 1 个点数。查看定价

更新日志

2.1.0

• transcribe_video 新增可选参数 includeComments，适用于 Instagram、TikTok 和 YouTube；该参数会转发至现有 API，不额外消耗点数。
• 获取的转录内容中包含类型化的评论行；不支持的 Facebook 请求会在创建任务前被拒绝。

2.0.0

兼容 ReelScribe /v1 API 于 2026-07-31 的变更。1.0.5 及更早版本针对当前 API 返回的数字有误，应升级。

破坏性变更：

• list_transcriptions 不再返回 total。该字段在端点改为基于游标的分页后，变成了当前页的长度，因此 1.0.5 会把“我有多少条转录？”回答为页面大小——拥有 2,000 条内容的资料库会返回 100——且响应中没有任何信息能揭示这一点。该字段已由 returned（当前页数量）、libraryTotal（仅当响应包含全部内容时才返回数字，否则为 null）、hasMore 和 nextCursor 取代。
• list_transcriptions 返回 500 个字符的转录预览和 transcriptChars，而非完整转录文本。完整文本请使用 get_transcription。
• get_credits 不再返回 storage.limit。各套餐的存储上限已取消；现在 API 对所有套餐都返回 -1（“无上限”），这会显示为“无限”，却掩盖了实际存在的 30 天保留期限。该字段已由 library.completedTranscriptions / library.isCapped 和 retention 区块取代。

新增：

• list_transcriptions 新增 cursor 和 limit 参数（默认值为 20，最大值为 200）。
• Facebook 视频和 Reel URL 现在会在本地验证；API 一直都接受这些 URL，但此前 validate_url 和 transcribe_video 会在发出请求前拒绝它们。
• search_transcriptions 会返回 matchesReturned，并说明其检索范围有限，因此 found: false 不再会被理解为“从未转录过”。

链接

• ReelScribe
• API 文档
• MCP 协议

许可证

MIT