| name | douyin-creator |
| description | 抖音创作发布：视频和图文发布到抖音创作者平台。覆盖视频规格(1080×1920竖屏/MP4 H.264)、图文轮播(2-35张)、描述(≤200字)、话题标签(3-5个)、AIGC标注、定时发布、封面选择。支持草稿和正式发布。触发：'发抖音'、'抖音发布'、'douyin publish'、'抖音视频'、'抖音图文'。 |
| author | Daniel Li |
抖音创作发布
- Author: Daniel Li
- Copyright © Daniel Li. All rights reserved.
排版规则
视频规格
| 项 | 规则 |
|---|
| 时长 | 15秒-60分钟（>15分需粉丝≥1000） |
| 格式 | MP4(H.264推荐)、MOV |
| 分辨率 | 竖屏1080×1920(9:16)最优，横屏1920×1080(16:9) |
| 帧率 | ≥30fps |
| 码率 | 2500-5000kbps |
| 大小 | ≤4GB |
图文规格
| 项 | 规则 |
|---|
| 图片数 | 2-35张（至少2张） |
| 格式 | JPG/PNG/WebP |
| 尺寸 | 竖版1080×1440(3:4)最优 |
| 大小 | ≤20MB/张 |
描述/标签
| 项 | 规则 |
|---|
| 描述 | ≤200字(含标签)，emoji适度(每2-3句1个) |
| 话题 | #话题名(无空格) 3-5个，精准在前泛话题在后 |
| @提及 | @相关账号增加互动 |
| 位置 | 可添加POI定位(本地内容推荐) |
| AIGC标注 | AI生成内容必须标注 "内容由AI生成" |
内容适配模板
视频发布描述模板
emoji 核心价值一句话
详细说明2-3句
@相关账号
#精准话题1 #精准话题2 #泛话题3
📍位置(可选)
图文描述模板
emoji 吸睛标题(类似小红书)
要点1
要点2
要点3
互动引导(提问)
#话题1 #话题2 #话题3
发布流程
视频发布
python scripts/douyin_publish.py \
--type video \
--file /path/to/video.mp4 \
--description "视频描述文字" \
--tags "话题1,话题2,话题3" \
--cover /path/to/cover.jpg \
--mode draft \
--cookie-file ~/.douyin_cookies.json
图文发布
python scripts/douyin_publish.py \
--type photo \
--images "/path/to/img1.jpg,/path/to/img2.jpg" \
--description "图文描述" \
--tags "话题1,话题2" \
--mode draft \
--cookie-file ~/.douyin_cookies.json
草稿模式（默认安全）
所有发布默认 --mode draft。草稿可在创作者平台管理。
正式发布
--mode publish 直接发布。可附加 --schedule "2026-03-20 20:00" 定时发布（最远10天）。
算法要点
- 发布后2小时内进入赛马机制
- 权重排序：完播率 > 点赞率 > 评论率 > 转发率
- 前3秒决定用户是否继续观看
- 话题标签影响推荐池分配
- 最佳发布时间：20:00-22:00（晚间黄金档）
错误处理
| 错误 | 处理 |
|---|
| 登录过期 | 提示重新扫码，headless=false |
| 滑块验证 | 暂停等待手动完成 |
| 视频转码失败 | 检查格式/分辨率，提示使用H.264编码 |
| 上传超时 | 大文件分片重试，指数退避(10s/30s/90s) |
| 图片≤1张 | 报错：图文至少需要2张图片 |
| 描述超长 | 截断到200字并警告 |
| 话题不存在 | 使用模糊匹配选择最近话题 |
发布前检查清单
文件结构
douyin-creator/
├── SKILL.md
├── scripts/
│ └── douyin_publish.py # Playwright 自动发布脚本
├── references/
│ └── platform-rules.md # 完整平台规则
└── templates/
└── description-template.md # 描述模板
