| name | douyin-posting |
| description | 协助用户将本地或用户提供的视频发布到抖音账号。包含上传流程说明、开放平台 API 使用指引及发布前检查。Use when: 用户要发抖音、上传视频到抖音、把视频发到抖音、post to Douyin、抖音发布。NOT for: 抖音视频下载、抖音数据分析、非发布类抖音操作。
|
douyin posting Skill 使用指南
抖音视频发布
何时使用
- 用户说「帮我把这个视频发到抖音」「上传到抖音」「发抖音」
- 用户提供视频文件并希望发布到抖音
- 用户询问如何用代码/脚本把视频发到抖音
- 用户说「这是抖音 openId / accessToken，配置上去」或「记录下来」「保存一下」
- 用户问「怎么获取 openId / accessToken」「如何授权」「怎么拿到 token」等
配置并记录 openId、accessToken
当用户提供 openId 和 accessToken 并要求「配置上去」或「记录下来」时：
- 将用户提供的 openId 和 accessToken 写入项目根目录的
.env 文件。
- 格式为（不要有多余引号或空格）：
DOUYIN_OPEN_ID=用户提供的openId
DOUYIN_ACCESS_TOKEN=用户提供的accessToken
- 若
.env 已存在，则只更新上述两个变量，保留其它变量不变。
- 告知用户：「已把 openId 和 accessToken 写入项目下的 .env，会一直保留，之后发抖音会优先用这份配置。」
项目中的 index.js 会自动读取 .env，无需用户再手动设置环境变量。
使用前必须检查
在协助发布（尤其是调用 API/脚本）之前，必须先确认用户是否具备：
- openId：用户唯一标识（通过抖音开放平台 OAuth 获取）
- accessToken：用户授权 access_token（同上）
若用户尚未提供或未获取这两项，应先引导用户按下面「如何获取 openId 与 accessToken」完成授权；若用户表示要「配置上去」「记录下来」，则按上节「配置并记录 openId、accessToken」写入 .env，不要直接执行上传/发布代码。
如何获取 openId 与 accessToken（直接引导）
当用户没有 openId/accessToken 且需要发抖音时，按以下步骤引导用户完成授权并拿到凭证。可逐条回复或给出链接与命令。
第一步：创建应用并配置（若尚未有）
- 打开 抖音开放平台 并登录。
- 进入「管理中心」→「应用管理」→「创建应用」，选择「移动应用」或「网站应用」等（根据实际类型）。
- 在应用详情里找到 client_key（应用唯一标识）和 client_secret（密钥），后续要用。
- 在应用里配置 重定向地址 redirect_uri：必须是 HTTPS 的完整 URL（不支持 http、localhost）。若本地开发，可用 ngrok、cpolar 等把本机端口映射为 https 地址，并把该地址填到开放平台「重定向地址」中。
- 申请发布视频能力：在「能力管理」→「能力实验室」中申请「代替用户发布内容到抖音」，审核通过后才有发布权限。授权时需勾选对应 scope（见下）。
第二步：让用户打开授权页拿到 code
- 拼出授权 URL（把下面参数换成用户自己的值）：
https://open.douyin.com/platform/oauth/connect/?client_key=你的client_key&response_type=code&scope=user_info,video.create&redirect_uri=你的redirect_uri的URL编码&state=任意字符串
scope 至少包含 user_info,video.create（发布视频需要）。redirect_uri 必须与开放平台里配置的完全一致，若含特殊字符需做 URL 编码。
- 让用户用浏览器打开该 URL，扫码或登录抖音并同意授权。
- 授权成功后页面会跳转到
redirect_uri?code=xxx&state=xxx，从地址栏或回调页拿到 code（code 约 10 分钟有效，且只能用一次）。
第三步：用 code 换 openId 和 accessToken
- 调用接口用 code 换 token：
- 接口：
POST https://open.douyin.com/oauth/access_token/
- Content-Type：
application/x-www-form-urlencoded
- Body 参数：
client_key、client_secret、code、grant_type=authorization_code
- 响应里会包含 open_id、access_token、refresh_token、expires_in（access_token 约 15 天有效）。把 open_id 和 access_token 给用户，或按用户要求写入项目
.env（见上节「配置并记录 openId、accessToken」）。
项目内已提供脚本：用户若已配置好 .env 中的 DOUYIN_CLIENT_KEY、DOUYIN_CLIENT_SECRET、REDIRECT_URI，拿到 code 后可在项目根目录执行：
node scripts/get-douyin-token.js <用户拿到的code>
脚本会输出 open_id 和 access_token，并询问是否写入 .env，从而完成「直接引导」获取并记录凭证。
官方文档链接（可发给用户）
核心流程
-
确认 openId 与 accessToken（见上「使用前必须检查」）
-
确认素材
- 视频文件路径或用户已提供的视频
- 标题、话题、封面（可选）、可见范围等发布参数
-
发布方式二选一
- 手动发布：引导用户使用抖音/抖音创作者中心网页或 App，按步骤上传并填写标题、话题等。
- 开放平台发布：若用户需要自动化，指引使用抖音开放平台（创作服务平台）的「发布视频」相关 API；需先完成企业/个人开发者认证与授权。
-
发布前检查
- 视频格式与时长符合抖音规范（常见：MP4，建议时长与尺寸参考当前平台规则）
- 标题、话题无违规词
- 若用 API，确认已获取有效 access_token 及发布权限
开放平台 API 要点
- 抖音创作服务平台/开放平台提供「发布视频」类 API，需 OAuth 授权。
- 典型步骤：获取用户授权 → 换取 access_token → 调用上传接口（先上传视频文件得到 video_id，再调用发布接口传入 video_id 与标题、封面等）。
- 具体 endpoint、参数以官方文档为准；回复用户时给出文档链接与关键参数说明，不编造 API 路径。
回复原则
- 用户仅问「怎么发抖音」：优先给出手动发布的简短步骤（App/网页入口 + 上传、填标题、选话题、发布）。
- 用户明确要自动化/脚本/API：说明需用开放平台，并列出步骤（认证、授权、上传接口、发布接口），可写示例调用流程（伪代码或示例请求），并提醒查阅最新官方文档。
- 若用户没有 openId 或 accessToken：按本 Skill 中「如何获取 openId 与 accessToken（直接引导）」逐步引导（创建应用、配置 redirect_uri、拼授权链接、用户扫码拿 code、用 code 换 token）；必要时可代用户拼好授权 URL 或说明运行
node scripts/get-douyin-token.js <code> --write 完成换取并写入 .env。
- 若用户未提供视频文件，先提示准备视频再继续。
示例话术
- 「要发抖音的话，可以：1）在抖音 App 里点「+」选本地上传；2）或用电脑打开抖音创作者中心网页上传。你这段视频打算用啥标题和话题？」
- 「用接口发抖音需要先在抖音开放平台创建应用并拿到授权，然后用上传接口拿到 video_id，再调发布接口。」
- 用户提供 openId/accessToken 并说配置上去时：「已把 openId 和 accessToken 写入项目下的 .env，会一直保留，之后发抖音会优先用这份配置。」
