agentleFS
DevinChen2014DevinChen2014/socialdatax-skills/skills/douyin-video-copy-extract/SKILL.md

douyin-video-copy-extract

Skill6 starsChanged yesterdayMITView on GitHub

用于抖音文案提取、抖音文案一键提取、抖音视频文案提取、抖音视频转文字、抖音口播转文字和抖音逐字稿。用户粘贴抖音视频链接、分享文案或 aweme_id 后,提取视频上下文、原视频简介和口播逐字稿。

  • Reads credentials

The file

Files
SKILL.md
<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->

抖音文案提取

适用场景

用于抖音文案提取、抖音文案一键提取、抖音视频文案提取、抖音视频转文字、抖音口播转文字和抖音逐字稿。用户粘贴抖音视频链接、分享文案或 aweme_id 后,提取视频上下文、原视频简介和口播逐字稿。

快速开始

  • 先给出当前 skill 支持的输入:视频链接、分享文案、内容 ID 或已有 job_id。
  • 你通常会得到:视频基础信息、原视频简介、口播逐字稿、可复制文案和精简版;未完成时先继续查询任务状态。

API Key 获取

获取或管理 API Key:访问 https://socialdatax.com/ai?from=github,按官网的 API Key 申请/管理入口操作。环境变量名固定使用 SOCIALDATAX_API_KEY;不要引导用户使用其他域名。

  • 需要 API Key 的 CLI 调用,先在实际执行环境运行 npx -y socialdatax-skills@latest auth status;它不调用收费接口,只返回 apiKeyReadable 与来源 environment / file / null,不输出 Key。已有可用配置时继续原任务;命令、权限或文件格式错误按实际错误处理,不一律判为没配置。已认证的 hosted MCP 沿用当前连接鉴权,不要求另配本地 CLI。
  • 缺少 Key 时,请用户从上述官网获取,在自己打开的本地终端运行 npx -y socialdatax-skills@latest auth login,按隐藏输入提示填写。Key 保存到该终端当前用户主目录下 .config/socialdatax/credentials.json;Unix 文件权限为 600,Windows 使用当前用户私有 ACL,无法限制权限时保存失败。真实 Key 不进入 AI 聊天、模型可见的命令输入、日志、截图、命令历史、Skill 文件或版本库;Agent 不读取或展示凭证文件内容。
  • CLI 每次调用都会读取该私有用户文件,不依赖客户端加载 Shell 配置,不需要改客户端或系统设置。非空 SOCIALDATAX_API_KEY 优先,既有旧兼容变量其次,最后读取文件;source=environment 时保存文件不会覆盖生效的环境凭证。鉴权失败先核对实际来源和账号,再由用户本地修正,保留其它配置。
  • 用户完成录入后,在实际业务命令的同一执行环境重新运行 auth status。false 时停止业务调用,核对操作系统用户、主目录与文件访问权限;true 只说明凭证可读,鉴权与结果仍以原业务请求返回为准,不为配置检查额外调用收费接口。
  • 远程或容器中的 CLI 读取远程或容器用户的配置,本机保存不会自动传入。只有具备可交互终端和持久主目录时,才在该执行环境本地录入;否则使用部署平台已有的 Secret / 环境变量注入方式。无法持久化或被沙箱阻止时说明实际限制,不复制 Key 到聊天、项目或临时命令,不绕过隔离。
  • 需要验收长期保存时,完全退出客户端及后台执行进程,重开后再次检查,再继续原请求。日常使用沿用已验证配置,不反复要求重启或重新录入。

直接调用命令

优先使用 direct CLI;能运行 shell 命令的 Agent 不需要额外配置 MCP server:

npx -y socialdatax-skills@latest douyin transcript \
  --url "<douyin_content_url_or_share_text>" --pretty \
  --source-client socialdatax-skills --source-platform github \
  --source-skill douyin-video-copy-extract

npx -y socialdatax-skills@latest douyin transcript \
  --aweme-id "<aweme_id>" --pretty --source-client socialdatax-skills \
  --source-platform github --source-skill douyin-video-copy-extract

npx -y socialdatax-skills@latest douyin transcript \
  --job-id "<job_id>" --pretty --source-client socialdatax-skills \
  --source-platform github --source-skill douyin-video-copy-extract

导出 SRT 字幕(direct CLI)

  • 用户需要字幕文件时,使用 CLI 0.2.64 或更新版本,在上方对应平台的 transcript 命令末尾追加 --srt-output ./video.srt;保留原有来源归因参数。该选项也适用于本 Skill 已列出的 URL、内容 ID 和任务查询入口,不扩展平台范围。
  • 先确认保存路径:父目录必须已存在且可写,目标文件不能已存在;CLI 不会覆盖已有文件。任务成功且返回有效时间分段时,CLI 写入 UTF-8 SRT,标准输出仍保留原始 JSON;以实际文件和保存成功提示确认导出完成。
  • 任务尚未完成时,沿用对应平台的 transcript --job-id <job_id> 示例并追加相同的 --srt-output ./video.srt,不要重新提交视频。
  • 路径预检失败且尚无 job_id 时,还没有提交转写任务;修正路径后继续原命令。已有 job_id 时,路径或文件写入错误不代表转写失败:保留已返回的 JSON,解决本地保存问题后用同一 job_id 重试。
  • 若返回的时间分段缺失或无效,保留 JSON 并说明无法生成 SRT,停止重复查询,不补造时间戳,也不重新提交视频。
  • --srt-output 只在 direct CLI 中执行本地保存,不是 hosted MCP 工具参数。若 MCP 已提交任务,需要导出时可在 CLI 中查询对应平台的同一 job_id;不能执行 CLI 时说明尚未生成本地 SRT 文件,不要重复提交任务。

参数说明

文案提取 / 转写:

  • 输入:--url <douyin_video_url_or_share_text>:当用户粘贴抖音视频链接、短链或分享文案,想做文案提取 / 口播转文字时使用。
  • 输入:--aweme-id <aweme_id>:当已经知道抖音视频 ID,想做文案提取 / 口播转文字时使用。
  • 输入:--job-id <job_id>:继续查询已有文案提取 / 转写任务;不要为了查询状态再次提交新任务。
  • 说明:单次文案提取 / 转写调用只能使用 --url、--aweme-id 或 --job-id 其中一种入口。

通用:

  • 可选:--pretty:只影响输出格式,不改变实际请求结果。
  • 可选:--source-client socialdatax-skills --source-platform github --source-skill douyin-video-copy-extract:这是当前 Agent Skill 的来源标记;按本 Skill 示例执行时保持这些值不变。

执行步骤:第一步,用 --url 或 --aweme-id 提交抖音视频文案提取;如果用户已经给了 job_id,直接用 --job-id 查询。 第二步,先看返回 JSON 里的 data.is_terminal:如果不是 true,复制同一个 data.job_id,运行上方 douyin transcript --job-id <job_id> 命令继续查询。 第三步,只有 data.is_terminal 是 true 时才交付结果:如果 data.status 是 succeeded,整理视频信息、简介和逐字稿;否则说明 data.error.message 或 data.message。 循环规则:每次查询返回后都先判断 data.is_terminal。只要 data.is_terminal 不是 true,就继续查询同一个 data.job_id;先等 data.next_poll_after_seconds,如果没有这个字段,就短暂等待后再查。 停止条件只有三类:终态、工具无法继续运行、用户要求停止。拿到 data.job_id 后,提交动作最多一次;不要重复提交同一个视频,不要把只有 data.job_id 的内容当作最终结果。 失败时,只在 data.error.retryable 是 true 时建议稍后重试;如果是 false,不要建议重复提交同一个视频。

输出建议

优先输出可直接复制的文案提取结果:视频基础信息、原视频简介、口播逐字稿、可复制文案和精简版;未完成时继续查询任务状态。

固定输出结构:任务成功后按以下顺序组织;字段只使用返回中可见内容,缺失时标注未返回,不补造。

  1. 视频基础信息:标题、作者、发布时间、时长、aweme_id、原始链接等;只有返回中存在时才输出。
  2. 原视频简介:优先使用 description,保留原意,适合用户直接复制或继续整理。
  3. 口播逐字稿:输出转写正文,尽量保持原口播顺序。
  4. 可复制文案版:基于原视频简介和口播逐字稿整理为便于复制的正文,不新增未出现的信息。
  5. 精简版:用短段落概括视频主要内容,方便用户快速判断是否继续复盘。
  6. 任务状态:如果任务未完成或失败,只输出 job_id、status、next_action、错误信息和是否可重试。

优先交付 description 原视频简介、口播逐字稿、可复制文案、精简版,以及返回中可见的视频上下文。 输出前先检查 data.is_terminal:如果不是 true,先用同一个 data.job_id 继续查询,不要提前写最终文案。只有工具无法继续运行、会话被中断或用户要求停止时,才输出 data.job_id、data.status 和 data.next_action,提示用户稍后继续查询。 只有 data.is_terminal 是 true 且 data.status 是 succeeded 时才输出逐字稿;失败时输出 data.error.message 或 data.message。 失败时先看 data.error.retryable:只有值为 true 才建议稍后重试;值为 false 时说明当前视频不适合重复提交。 如果结果显示没有可处理的视频资源或任务失败,按当前任务结果说明,不要换平台重试。 除非用户另行要求,当前 skill 只做文案提取和任务状态续查,不扩展到其他分析或改写任务。

MCP 工具

与上面 direct CLI 命令对应的 MCP 工具:

  • douyin_submit_video_speech_text_by_video_url
  • douyin_submit_video_speech_text_by_aweme_id
  • douyin_get_video_speech_text_job

如果当前 Agent 已接入 MCP 工具,只使用抖音视频文案提取对应工具:douyin_submit_video_speech_text_by_video_url、douyin_submit_video_speech_text_by_aweme_id、douyin_get_video_speech_text_job。 继续查询已有任务时,调用 douyin_get_video_speech_text_job;不要为了轮询状态再次调用 submit 工具。任务未到终态时继续用同一个 job_id 查询。

安全边界

这是只读 skill,可通过 direct CLI 或 hosted MCP 提交有限范围的视频转文字分析任务,也可以查询已有任务状态。 仅在用户要求导出 SRT 时,direct CLI 会向用户指定的新文件写入字幕,不覆盖已有文件。 CLI 使用已有环境凭证或用户本地保存的私有凭证文件;生成的 Skill 文件不包含 API Key。 不会读取本地浏览器数据,也不会执行登录、发帖、点赞、评论或账号修改。

示例结果

  • 示例展示格式,不代表固定字段:成功=视频基础信息/原视频简介/逐字稿/可复制文案/精简版;未完成=继续查询同一 job_id;失败=错误原因/是否可重试/下一步。

异常处理

  • 如果出现 SDK/依赖缺失、npm 网络、Node.js/npm/npx 不可用或执行权限错误:这是本地运行环境、依赖安装、网络或 AI 平台授权问题,不是 SocialDataX API Key 或业务数据返回错误。仅在用户已授权的范围内安装或修复本任务所需依赖,优先使用项目目录或临时环境。环境执行权限不等于用户授权;超出授权范围时,先说明具体改动并征得同意,包括全局安装、运行时升级或系统配置变更。需要网络或执行授权时提醒用户同意或完成授权;处理后继续原命令;不要改用公开网页搜索替代 SocialDataX 数据。
  • 凭证来源排查:先确认本次调用使用 CLI 还是 MCP。CLI 在实际执行环境中用 auth status 确认环境或本地文件来源;MCP 检查当前连接实际使用的鉴权配置,不要求另设本地 CLI 变量。配置缺失时按「API Key 获取」由用户本地隐藏录入;不要输出 Key、Authorization header 或秘密配置值。
  • 提交或查询异常:保留错误信息,按上述实际凭证来源核对配置,并检查输入链接或 ID、以及 job_id 是否完整。
  • 如果返回 insufficient_balance 或“积分不足”:不要重复提交或反复查询;展示错误中的官方充值链接(https://socialdatax.com/dashboard/billing,可带渠道参数);若没有该链接,使用 https://socialdatax.com/dashboard/billing。充值后继续刚才失败的调用;已有任务或部分结果时,按对应任务查询、分页续查规则恢复。
  • 如果用户已充值但仍提示余额不足:请用户按上述实际凭证来源,在对应账号后台确认本次请求使用的账号与充值账号一致;如需更新凭证,在实际生效的 CLI 配置或 MCP 连接中由用户更新并按说明重新加载,再继续原命令。不要仅因本地新变量缺失就要求重新配置,也不要展示凭证明文。
  • 如果提交失败且没有返回 data.job_id,确认参数和 API Key 后可以重新提交;如果已经拿到 data.job_id,后续异常只查询同一个任务,不要重复提交视频。
  • 任务失败:优先展示 data.error.message 或 data.message;只有 data.error.retryable 是 true 时才建议稍后重试。

常见问题

  • 没结果:确认视频链接、分享文案、内容 ID 或 job_id 完整。
  • 调用失败:按「异常处理」核对本次调用实际使用的凭证来源;如果已有 job_id,只查询同一个任务;如果没有 job_id,再检查输入格式;如果是 insufficient_balance 或“积分不足”,按上述官方充值链接说明完成充值后,按上述恢复规则继续,不要反复重试。
  • 担心账号安全:这是只读能力,不登录、不发帖、不点赞、不评论。
  • 想整理成文案:先等任务成功,再基于逐字稿和返回上下文整理可复制版本。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.