Douyin Publish
Apps & Automationdouyin-publishDouyin Publish is an Agent Skill for apps & automation published in the TeamWiseFlow/xiaobei repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
通过浏览器自动化发布视频到抖音创作者中心。纯浏览器操作方案。
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/TeamWiseFlow/xiaobei/blob/HEAD/crews/main/skills/douyin-publish/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/douyin-publish, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
抖音内容发布
通过 camoufox-cli 持久化 session douyin(一个且只有一个持久化 session,fail-first 队列:同 session 已有命令在跑时新命令直接 fail)在抖音创作者中心发布视频。
纯浏览器操作方案:本 skill 自身不吃 cookie,严禁通过
cookies import导入 cookie 造登录会话——浏览器操作一律走 login-manager 真实登录后的持久化 session(登录态 + 指纹冻结在 session profile 里)。使用login-manager技能完成登录操作:login-manager会引导用户完成手机号+验证码 / 抖音 APP 扫码登录,以及导出 cookie + UA 落中央存储,这是为了供非浏览器类脚本(
viral-chaser、published-track等)消费。导出 + 有头登录由 login-manager 负责,本 skill 只消费 login-manager 留下的持久化 session。
职责划分(与 login-manager 的边界)
| 职责 | 归属 |
|---|---|
| 探活(验 session 是否仍登录态) | login-manager |
| 有头手动登录(手机号+验证码 / 抖音 APP 扫码) | login-manager |
| 导出 cookie + UA 落中央存储 | login-manager |
| 复用持久化 session 做浏览器发布操作 | douyin-publish(本 skill) |
前置条件
- login-manager 已就位:持久化 session
douyin是登录态,且中央存储~/.openclaw/logins/douyin.json+~/.openclaw/logins/douyin.ua.json已导出(cookie + UA 同一指纹,供 viral-chaser / published-track 消费)。- 首次使用 / 登录态失效时,调用方走 login-manager 有头手动登录流(不在本 skill 内做):
camoufox-cli --session douyin --persistent --headed --json open "https://creator.douyin.com/"- 告知用户「抖音 浏览器已打开,请在窗口里手动完成创作者中心登录(手机号+验证码 / 抖音 APP 扫码),完成后告诉我」
- 登录就位后同时导出 cookie + UA(由 login-manager 流程负责):
camoufox-cli --session douyin --persistent --json cookies export ~/.openclaw/logins/douyin.jsoncamoufox-cli --session douyin --persistent --json identity export ~/.openclaw/logins/douyin.ua.json
- 登录后不关 session——持久化 session
douyin登录态留着给本 skill 做发布操作复用,主动 close 会破坏复用。
- 首次使用 / 登录态失效时,调用方走 login-manager 有头手动登录流(不在本 skill 内做):
- 视频文件准备好(mp4 / mov)
- 抖音创作者中心已实名认证(必须,本人手机号 + 身份证)
同时导出 cookie 和 UA:抖音设备指纹 cookie 必须配同一指纹的 UA,否则被风控错配。本 skill 走持久化 session
douyin(登录态 + 指纹冻结在 session profile 里),自身运行不读中央 cookie 文件——探活也是open + snapshot看跳登录页,不走中央存储。导出 cookie+UA 落中央存储仅为供 viral-chaser / published-track 等下游脚本消费(不是本 skill 用)+ 与 login-manager 5 平台统一步骤保持一致。
使用方式
一键全流程
douyin-publish run \
--video /path/to/video.mp4 \
--title "视频标题" \
--caption "视频描述 #话题1 #话题2"
run 内部串:upload → fill → publish → get-link。不自管 login 探活——探活交 login-manager,由调用方在调 run 之前确认 session 已登录。
分步调用(agent 按需)
# 1. 上传视频(返回 session 名,后续步骤用)
douyin-publish upload --video video.mp4
# 2. 填标题/描述
douyin-publish fill --session <s> --title "标题" --caption "描述"
# 3. 点发布
douyin-publish publish --session <s>
# 4. 取视频链接
douyin-publish get-link --session <s>
注意:本 skill 没有
login子命令、也没有cleanup子命令——探活/登录/导出 cookie+UA 全交 login-manager;持久化 sessiondouyin不主动 close(登录态留着下次用),只在 session 卡死时由调用方手动camoufox-cli --session douyin --json closeteardown。
创作者中心 URL
上传页:https://creator.douyin.com/creator-micro/content/upload?enter_from=dou_web
视频管理页:https://creator.douyin.com/creator-micro/content/manage(取链接用)
必做约束
- 不主动 close 持久化 session
douyin——登录态 + 指纹冻结留着下次用。只在 session 卡死时camoufox-cli --session douyin --json closeteardown。 - 同 session 已有命令在跑时,新命令 fail-first(返回
session douyin 正忙,请等待当前操作完成后再试)——读到这条文本就等当前操作完成再重试,不要盲试。 - 严禁
cookies import:浏览器操作不开临时 session 再 import cookie 那一套,会触发平台风控。 - 不导出 cookie / UA:导出是 login-manager 的事,本 skill 不调用
cookies export/identity export。
Pitfalls
pitfall: douyin_login_required_on_creator_center
- 触发:访问
creator.douyin.com未登录态 - 症状:页面跳到
creator.douyin.com/login或出现登录弹窗 - workaround:脚本返回
exit 2(session 失效),由调用方走 login-manager 有头手动重登流,不在本 skill 内自管重登。
pitfall: real_name_auth_required
- 触发:未实名认证的账号
- 症状:创作者中心提示"请先完成实名认证"才能发布
- workaround:用户自己走实名认证流程(脚本帮不上)
pitfall: video_too_long_or_wrong_format
- 触发:上传非 mp4 / mov 格式,或视频时长超限
- 症状:上传后转码失败 / 客户端拒收
- workaround:转 mp4 + 检查时长(抖音支持最长 15 分钟)
pitfall: dom_changes_creator_center
- 触发:抖音创作者中心前端改版
- 症状:selector 找不到(input / button 位置变化)
- workaround:部署后真机验证更新 selector(见
docs/post-deploy-verification.md);首轮交付 selector 是公开推测
pitfall: rate_limit_after_burst_publish
- 触发:短时间内连续发布多条
- 症状:平台风控 / 上传被拒 / 提示"操作过于频繁"
- workaround:每天 ≤ 5 条;触发后 30 分钟内不重试
Notes
- Docker 内对内 crew exec full(无 allowlist 限制)
- 限频建议:单抖音号每 24h ≤ 5 条发布;触发风控立即降级
- 失败回退:浏览器模拟失败 → 维持现状(让用户自己手动发)
- 抖音创作者中心 DOM 改版频繁:selector 需部署后真机验证(见
docs/post-deploy-verification.md) - 形态仿 wechat-channels-publish:5 个子命令(upload / fill / publish / get-link / run),无 login 子命令、无 cleanup 子命令。run 命令一键跑全流程。走持久化 session
douyin(登录态 + 指纹冻结在 session profile 里),跑完不主动 close。上传走camoufox-cli upload命令(底层 PlaywrightsetInputFiles)。等待页面状态变化(轮询body.innerText)。失败模式:DOM 改版 / 按钮找不到 / 转码超时。