技能介绍

解决什么问题

抖音视频的文案和口播内容很难直接拿到：平台既不提供逐字稿，也不给可复制的文案版本。做自媒体运营或短视频脚本整理时，经常需要从一条视频里提取标题、原简介和口播文字，再整理成自己的素材。这个技能就是为这件事提供一个明确的入口：粘贴公开视频链接、分享文案或 aweme_id，提交转写任务，拿到结构化结果。

核心能力与工作流程

输入方式：单次调用只能用 --url、--aweme-id 或 --job-id 三者之一，分别对应视频链接/分享文案、已知内容 ID、以及继续查询已有任务。已经拿到 job_id 时不要重复提交同一个视频。

任务提交与轮询：命令通过 SocialDataX 后端执行，需要环境变量 SOCIALDATAX_API_KEY。提交后先检查返回 JSON 中的 data.is_terminal：不是 true 就复制同一个 data.job_id，等待 data.next_poll_after_seconds（没有该字段则短暂等待）后继续查询。停止条件只有三类：任务到达终态、工具无法继续运行、用户要求停止。

成功输出：任务成功后按固定顺序组织——视频基础信息（标题、作者、发布时间、时长、aweme_id、原始链接，仅输出返回中存在的字段）、原视频简介、口播逐字稿、基于前两者整理的可复制文案版（不新增未出现的信息）、以及一段用于快速判断的精简版。字段缺失时标注「未返回」，不补造。

失败处理：data.status 不是 succeeded 时，输出 data.error.message 或 data.message。只有 data.error.retryable 为 true 才建议稍后重试；为 false 说明当前视频不适合重复提交。遇到 insufficient_balance（积分不足）时不要反复重试，把错误里的充值链接原样展示给用户，充值后重新执行同一条命令即可。

适用边界

这是一个只读技能：不登录账号、不发帖、不点赞、不评论、不修改任何账号数据，也不读取本地浏览器数据。只处理公开可访问的抖音视频，范围限于文案提取和任务状态续查，不扩展到其他数据分析或改写任务。本地环境缺少 Node.js/npm/npx、依赖安装失败或网络问题属于运行环境故障，与 API Key 或业务数据返回无关，按环境问题排查即可。