技能介绍

这个技能解决什么问题

拿到一条短视频，真正需要的是口播逐字稿和能直接复用的文案。手动整理意味着反复拖进度条、暂停抄写，再从视频简介里拼凑信息，耗时且容易出错；各平台链接格式也不一样，很难拿到结构化字段。这个技能把这条链路压成一次 transcript 调用：给定公开视频链接、分享文案、内容 ID 或已有 job_id，返回视频基础信息、原视频简介、口播逐字稿、可复制文案和精简版，便于继续做逐字稿整理与复盘。

核心能力与调用流程

按平台选命令：小红书、抖音、快手、视频号使用 --url，微博使用 --post-url；已知内容 ID 时改用对应入口，例如 --note-id、--aweme-id、--photo-id、--post-id、--encrypted-object-id。
单入口原则：一次调用只能使用 URL/share text、平台内容 ID 或 --job_id 其中之一，不要混用，也不要重复提交同一个视频。
轮询异步任务：提交后先看返回 JSON 里的 data.is_terminal。若不是 true，复制同一个 data.job_id，用同平台的 --job-id 继续查询；先等待 data.next_poll_after_seconds，没有该字段就短暂等待后再查。
终态才交付：只有 data.is_terminal 为 true 且 data.status 是 succeeded 时，才整理视频信息、简介、逐字稿与精简版。失败时展示 data.error.message 或 data.message。
固定输出顺序：视频基础信息、原视频简介、口播逐字稿、可复制文案版、精简版、任务状态。字段只使用返回中可见内容，缺失时标注未返回，不补造。
两种接入方式：能运行 shell 的 Agent 直接用 direct CLI；已接入 MCP 的 Agent 调用对应的 submit/get 工具。

适用边界与注意点

当前 direct CLI 只覆盖小红书、抖音、快手、微博和视频号五个平台，其他平台不在范围内，应先确认是否存在对应口播转文字入口，不要拼接不存在的命令。这是只读技能，不登录、不发帖、不点赞、不评论，也不读取本地浏览器数据；运行依赖环境变量中的 SOCIALDATAX_API_KEY，Skill 文件本身不包含密钥。遇到 insufficient_balance 或「积分不足」时不要反复重试，按错误里的充值链接充值后继续执行同一条命令。若 data.error.retryable 是 false，说明当前视频不适合重复提交，只需说明原因。