技能介绍

解决什么问题

短视频运营和内容复盘常卡在第一步：素材能看，但文案不在手里。分享链接可能只带标题，真正表达信息的口播内容需要重新听写、整理，才能做二次创作、检索和归档。这个 Skill 把这类“听视频、取文案、整理逐字稿”的动作收敛成一条可重复调用的流程，避免在多个页面之间手工复制。

技能如何工作

它面向公开视频内容，当前 direct CLI 支持 小红书、抖音、快手、微博、视频号；可用输入包括视频链接、分享文案、内容 ID 或已有 job_id。提交后通常能得到视频基础信息、原视频简介、口播逐字稿、可复制文案和精简版，适合继续整理而不是直接完成创作。

关键步骤：

按平台选择对应入口；URL/share text、平台内容 ID 或 --job-id 三选一，不混用。
提交后先读 data.is_terminal；不是终态就用同一个 data.job_id 继续查询，不重复提交视频。
到终态后再判断 data.status：成功才整理逐字稿和文案；失败则展示 data.error.message 或 data.message。
只有 data.error.retryable 为 true 时才建议稍后重试；false 说明当前视频不适合重复提交。

适用边界与注意点

这是只读能力，用于有限范围的视频转文字分析，不登录、不发帖、不点赞、不评论、不改账号。运行时读取环境变量 SOCIALDATAX_API_KEY；若返回 insufficient_balance 或“积分不足”，不要反复重试，应按错误中的充值链接处理。若任务未完成，先继续查同一个 job_id；不要把 job_id 当作最终结果。若本地缺少 Node.js/npm/npx、依赖或执行权限，先修复运行环境，不要用公开网页搜索替代 SocialDataX 数据。