TikTok 转录文本

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install tiktok-transcript
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 tiktok-transcript。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

TikTok Transcript 是一项 OpenClaw skill，可将受支持的公开视频链接转换为实用文本。它可以返回带有分段时间戳的语音转录文本、屏幕文字、标题、作者、说明文字、要点、标签以及可用的互动数据。支持的来源包括 TikTok、Xiaohongshu、YouTube 和 X；不支持 Bilibili。
该 skill 会将提供的链接发送给 LinkDigest，无需 TikTok 账号、cookies、本地视频下载、ffmpeg 或语音识别模型。没有 API key 时，每天可免费生成一份摘要。添加 LinkDigest API key 后，即可完整访问转录文本，并使用 JSON 输出、翻译、部分处理和长视频转录模式等其他选项。

应用场景

提取 TikTok 公开视频中的语音内容和字幕。
用户分享链接时，对受支持的视频进行摘要或翻译。
查看教育、教程或商业视频；这类视频中的屏幕文字与旁白同样重要。
每次处理一个链接，以整理竞争对手或参考视频内容；也可使用文档说明的批量 API，一次最多处理 50 个链接。
获取视频元数据、要点、标签，以及可用的点赞、评论、收藏、分享和播放次数。

工作原理

接收受支持的视频 URL，或包含链接的复制分享文本块。
使用附带的 Python 客户端或 HTTP API 将链接提交给 LinkDigest。客户端需要 Python 3.8+，并使用标准库。
LinkDigest 处理公开视频，并返回可用的元数据、转录片段、屏幕文字和要点。转录可能使用平台字幕或 Qwen3-ASR；YouTube 的处理方式不同，可能会使用 Gemini 解读视频。
对于较长的任务，收到 202 待处理响应后，轮询返回的任务 ID。任务处理期间不要再次提交相同链接。
按所选格式呈现用户要求的结果。将旁白与屏幕文字分开；除非用户要求改写，否则保留原始转录文本；必要时说明结果不完整，或 YouTube 文本由模型生成。

配置指南

确保可使用 Python 3.8 或更高版本，以运行附带的客户端。也可以使用 curl 调用 HTTP API。
如需完整结果，请在 https://linkdigest.dev/app/keys 创建 LinkDigest API key。新账号无需添加付款卡即可获得 10 个注册额度。密钥以 ld_live_ 开头。
将密钥设为环境变量，或在 skill 的 OpenClaw env 设置中配置。每日免费摘要无需密钥。
export LINKDIGEST_API_KEY=ld_live_...
python3 {baseDir}/scripts/linkdigest.py ""
根据需要选择 JSON 输出、翻译或额度上限：
python3 {baseDir}/scripts/linkdigest.py "" --format json
python3 {baseDir}/scripts/linkdigest.py "" --translate-to en
python3 {baseDir}/scripts/linkdigest.py "" --max-credits 5
如需直接调用 API，请发送 POST https://linkdigest.dev/api/v1/digest，并附上 Bearer token 以及包含 URL 的 JSON 请求体。202 响应表示任务待处理；轮询提供的任务 ID，直到任务完成。仅将 API key 存储在环境变量或安全配置中，不要放入提示词、源代码或提交记录。

数据架构

该 skill 以 JSON 或 Markdown 格式返回结果。常见 JSON 字段包括：
Field Contents
title, author, posted_at, caption 视频标题、创作者、发布日期，以及可用时的原始说明
transcript[] {t, text} 格式的语音文本片段，其中 t 是片段的起始时间，单位为秒
transcript_source 转录来源：asr、native_captions、gemini_video 或 none
on_screen[] 提取的屏幕文字及其大致时间戳；YouTube 不提供此项
ocr_text[] 汇总后的屏幕文字，不含时间戳
key_points[], tags[] 关键要点和主题标签
stats 可用的点赞、评论、收藏、分享和播放次数，以及 as_of 日期；不可用的值可能为 null
duration_seconds, read_seconds 视频时长和已处理时长
partial 部分读取时提供，包含读取时长和额度详情
translation 请求 translate_to 时提供的额外译文；原始字段保持不变
raw_markdown 以 Markdown 格式呈现的完整结果，包括转录文本和屏幕文字部分
credits, cached 扣除的额度，以及是否使用了缓存结果
degraded[] 无法完成的处理组件的相关说明
转录时间戳对应片段，而非单词或句子。ASR 音频会分块处理，每块最长约 170 秒，并带有起始时间。屏幕文字从最多 40 个画面中采样，因此可能遗漏短暂出现的文字，时间戳也只是近似值。结果按链接缓存；互动统计反映的是某一时点的快照，不一定是当前数量。

高级特性

异步任务处理：
附带的客户端可处理
响应和轮询，默认最多等待 900 秒。如果轮询超时，可使用任务 ID 恢复；每个任务只计费一次。
输出控制：
请求 JSON 或 Markdown 输出，使用 --translate-to 翻译结果，并使用 --max-credits 设置额度上限。
部分处理： --partial-ok ，在可用额度范围内读取符合条件的长视频开头；响应会说明已处理的内容长度。
长视频转录模式：
文档说明的
depth: transcript
模式以较低成本提供完整转录文本，但画面采样有限，且有单独的时长限制。YouTube 不支持此模式。
批量处理：
LinkDigest 批量端点每次请求最多支持 50 个链接。
集成选项：
LinkDigest 还提供 Streamable HTTP MCP 端点、OpenAPI 规范、Dify 插件和开源 MCP 客户端。
运行保障：
客户端会在 stderr 中报告额度和缓存详情，对常见错误使用不同的退出代码，并且不会读写本地文件。避免使用私密、已删除、需要登录或正在直播的视频链接；该服务处理公开视频链接，并可能缓存文本结果。

name: tiktok-transcript description: "TikTok video to transcript: the spoken words with timestamps, on-screen captions, title, hashtags, key points and like/comment counts. Use when the user shares a tiktok.com or vm.tiktok.com link and wants the transcript, the captions, a summary or a translation. Works without a key for one free summary a day; with a free API key (10 credits on sign-up, no card) you get the full transcript, 2 credits per minute of video. No download, no TikTok account or cookie needed." version: 1.0.0
homepage: https://linkdigest.dev/zh/docs