linkscribe

linkscribe

把链接交给 linkscribe，即可获取文字。linkscribe 会连接 txscribe 账户：粘贴录音链接——YouTube 视频、Google Drive 文件或 Dropbox 共享链接——服务便会 转录内容（录音会直接在原处转录， 不会下载）。之后，你可以按所需格式阅读完成的 转录文本、请求摘要、搜索 所有录音，找到某个词语或短语出现的时刻，并 清理不再需要的录音。

八个工具：

• list_transcriptions — 按时间从新到旧列出你的转录， 支持使用 limit / cursor 分页，并可选用 status 筛选。
• search_transcriptions — 搜索说过的内容，而不是标题： 每段录音最多返回五条匹配结果，并标明每条匹配开始的秒数。
• transcribe_link — 根据链接创建转录 （YouTube、TikTok、Instagram、X (Twitter)、Facebook、Vimeo、Loom、Dropbox）。可选设置 language（"auto" 或 en-US 等代码）、diarization 和 captions（仅限 YouTube：适用时使用 视频自带字幕）。会消耗你的分钟数。
• get_transcription — 获取一项 转录的状态和元数据。
• get_transcript — 获取完成的转录文本，格式可选 json （片段、词语时间戳、说话人）、txt、docx、pdf、 srt、vtt、fcpxml、premiere、nvivo、maxqda 或 atlasti；可选设置 timestamps 和 speakers，并可通过 from / to（单位为秒）仅返回某个时刻附近的 段落。
• get_summary — 获取摘要及其状态。
• request_summary — 请求生成摘要或重新生成摘要，可指定输出 language 和录音类型（scene，例如会议、访谈、讲座；省略时由模型选择）。
• delete_transcription — 删除一项转录及其生成的 所有内容。此操作无法撤销。

每次调用都会使用你自己的 txscribe API 密钥：

export TXSCRIBE_API_KEY="txs_live_…"   # sent as Authorization: Bearer <key>
# optional: export TXSCRIBE_API_BASE="https://txscribe.ai/api/v1"

如果未设置 TXSCRIBE_API_KEY，服务仍会启动并 列出其工具，但每次工具调用都会失败，并返回 TXSCRIBE_API_KEY is not set，且不会发出请求。成功时，工具会原样返回上游 JSON 正文。 如果错误正文包含代码，上游错误会显示为 txscribe error: <code> (HTTP <status>)；否则显示为 txscribe error: HTTP <status>。服务无法访问时 会显示为 txscribe unreachable。

按设计，本项目不包含：原服务中的 REST webhook 端点和 文件上传流程不是 MCP 工具，因此 linkscribe 也不会提供这些功能。原项目的 README 还提到了 get_transcript 的 summaryOnly 标志；它未出现在已发布的 OpenAPI 文档中，因此这里不提供。

CLI

每个工具都是一个子命令，接受一个 JSON 参数字符串：

npx @reneturcios/linkscribe list_transcriptions '{"limit":10}'
npx @reneturcios/linkscribe search_transcriptions '{"q":"budget"}'
npx @reneturcios/linkscribe transcribe_link '{"url":"https://youtu.be/…","diarization":true}'
npx @reneturcios/linkscribe get_transcript '{"id":"<id>","format":"srt"}'
npx @reneturcios/linkscribe request_summary '{"id":"<id>","scene":"meeting"}'
npx @reneturcios/linkscribe --version

输出为工具的结果文本。退出代码：成功时为 0， 运行时错误（包括验证失败或 txscribe 错误）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/linkscribe mcp

MCP 客户端配置：

{
  "mcpServers": {
    "linkscribe": {
      "command": "npx",
      "args": ["-y", "@reneturcios/linkscribe", "mcp"],
      "env": {
        "TXSCRIBE_API_KEY": "txs_live_…"
      }
    }
  }
}

Docker

docker run -i -e TXSCRIBE_API_KEY="txs_live_…" ghcr.io/cloudcorprecords/linkscribe
docker run --rm -e TXSCRIBE_API_KEY="txs_live_…" ghcr.io/cloudcorprecords/linkscribe list_transcriptions '{}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

许可证

MIT — 版权所有 (c) 2026 Rene Turcios