Run any Skill in Manus with one click

douyin-smart-publish

Stars77

Forks18

UpdatedApril 17, 2026 at 16:22

抖音创作者平台智能发布（视频/图文）：内容适配→上传→填描述/#话题→封面→存草稿→截图回传确认。默认只存草稿；只有在 Daniel 明确确认后才允许点击发布。覆盖标题(≤55字)、描述(建议≤200字)、#话题标签(3-5个)、封面设置、定时发布、可见性、合拍/下载开关。Playwright 自动化。触发：'发抖音'、'抖音发布'、'douyin publish'、'抖音图文'、'抖音视频'、'发布短视频'。

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

aAAaqwq

aAAaqwq/AGI-Super-Team

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

6 files

SKILL.md

readonly

抖音智能发布 v1.1

📋 发布前请确认内容合规：~/clawd/projects/MediaClaw/references/platforms/douyin.md（社区公约11大类违规、AIGC标识、账号健康分）

⚠️ 默认发布策略

默认目标是存草稿，不是直接发布。
只有 Daniel 明确确认后，才允许点“发布”。
在自动化填完内容后，优先截图回传当前页面，确认标题/描述/封面/话题都正确。
如果遇到登录验证、滑块、频率限制、上传卡住，不要死磕；保留截图和当前状态，转为“待 Daniel 接管”。

⚡ v1.1 安全增强

Pre-flight Checklist（飞行前检查）

每次发布前必须验证以下所有项目，缺一不可：

# 1. 浏览器连接测试
curl -s http://127.0.0.1:18800/json/version | grep -q webkit && echo "✅ Browser OK" || echo "❌ Browser Down"

# 2. 登录态验证
python3 scripts/publish.py doctor --no-headless \
  --url "https://creator.douyin.com/creator-micro/content/upload?default-tab=3" \
  --screenshot /tmp/douyin_preflight.png

# 3. 文件验证
ls -lh "$VIDEO_OR_IMAGE_FILE"

检查清单：

浏览器运行中
登录态有效（未过期）
文件存在且格式正确
doctor 冒烟测试通过（selector 都能找到）

Safety Screenshots（安全截图）

在每个按钮点击前必须截图当前状态：

打开上传页 → [截图#1: 页面加载] → 上传文件 → [截图#2: 文件上传完成]
→ 填描述 → [截图#3: 描述已填] → 设置封面 → [截图#4: 封面已选]
→ 填话题 → [截图#5: 话题已填] → 点击存草稿 → [截图#6: 草稿确认]

截图命名：/tmp/douyin_safety_{N}_{step_name}_{timestamp}.png

Error Escalation（错误升级规则）

3次失败即停止：

失败点	失败次数	行为
文件上传	≥3次失败	停止，截图，报告
描述填充	≥3次失败	停止，截图，报告
按钮点击	≥2次失败	停止，截图，报告
登录验证	失败	停止，提示重新登录

停止后操作：

截图当前页面
保存所有安全截图到 /tmp/douyin_safety/
报告具体失败步骤和错误信息
转为"待 Daniel 接管"

恢复模式（Recovery）

如果发布流程中断：

检查草稿箱：https://creator.douyin.com/creator-micro/content/manage
查看安全截图：ls /tmp/douyin_safety/*.png
判断是否需要重跑：
- 截图#5已存在 → 草稿按钮前失败了，需要重跑
- 截图#4已存在 → 话题填写后失败了，需要重跑
- 截图#2已存在 → 文件已上传，可跳过上传步骤
重新运行时使用 --mode draft，绝不自动切换到 --mode publish

草稿按钮文案变体

已知变体（抖音 UI 经常变化）：

文案	出现场景	对应 selector
`存草稿`	视频上传页	`button:has-text('存草稿')`
`暂存离开`	图文上传页	`button:has-text('暂存离开')`
`草稿`	部分版本	`button:has-text('草稿')`

脚本已覆盖所有变体：button:has-text('存草稿'), button:has-text('草稿'), button:has-text('暂存离开')

平台入口

创作者中心: https://creator.douyin.com
内容上传: https://creator.douyin.com/creator-micro/content/upload
图文上传: https://creator.douyin.com/creator-micro/content/upload?default-tab=3
登录方式: 抖音 APP 扫码 / 手机号验证码

发布类型

类型	URL参数	说明
视频	`default-tab=1`(默认)	短视频/长视频
图文	`default-tab=3`	图片轮播+描述
全景视频	`default-tab=3`(全景)	VR视频
文章	`default-tab=4`	长文(≤8000字+30图)

排版规则

视频规范

项	规则
时长	15秒-60分钟（≥15分钟需粉丝≥1000）
格式	MP4, WebM（推荐MP4 H.264）
分辨率	≥720×1280，推荐1080×1920，最高4K
帧率	≤60fps，推荐30fps
大小	≤16GB
画幅	9:16竖屏(最优) / 16:9横屏 / 3:4 / 4:3

图文规范

项	规则
图片数量	2-35张
格式	JPG, JPEG, PNG, WebP（不支持GIF）
大小	单张≤50MB
比例	推荐3:4或4:3，不建议超过1:2

描述/标题规范

项	规则
标题	≤55字（实测，超出截断显示）
描述	建议≤200字（含话题标签）
话题	#话题名格式，3-5个，精准在前泛在后
@提及	@用户名增加互动
POI定位	可添加位置（本地推荐加权）
emoji	适度使用，每2-3句1个

封面规范

项	规则
视频封面	从视频帧选取或自定义上传(1080×1920)
图文封面	从已上传图片中选择
推荐	竖版9:16，清晰大字，对比色

AIGC标注要求（2023.9起）

AI生成内容必须标注 "内容由AI生成"
虚构情节标注 "情景演绎，仅供娱乐"

内容适配模板

将内容转化为抖音格式时：

标题/描述：开头放核心信息(前3秒法则)，加emoji和话题标签

核心卖点/痛点句 emoji

补充说明(1-2句)

#精准话题1 #精准话题2 #泛话题3

话题策略：1-2个精准话题 + 2-3个泛话题，避免无关话题(判标题党)
描述字数：控制在100-200字，简洁有力
互动引导：结尾加提问或CTA

发布流程

关键安全门：截图确认 → 再发布

自动化填完以后，先截图（作为确认凭证）。
默认只执行 存草稿。
只有收到 Daniel 明确确认，才允许切换到 --mode publish。

需要接管/风控/停手规则：见 references/handoff-and-human-trace.md

2026-03-27 实战验证结论（已跑通）

这份 skill 已经在真实抖音创作者后台完成过一次完整图文草稿测试，链路如下：

复用 storage_state 登录态进入创作者后台
成功上传 3 张图片
成功填写标题
成功填写描述
成功点击草稿按钮并存入草稿箱

这次实战得到的关键经验：

先授权，再发布：未登录时页面里可能根本没有上传控件，不能把“上传失败”误判成 selector 问题。
登录判断不能只看 URL：即使 URL 已在 creator-micro/* 下，页面仍可能是扫码登录态；要同时检查页面文案/二维码区。
当前抖音图文页的草稿按钮文案可能不是 存草稿，而是 暂存离开。
图文页存在真实 inp 6ut[type=file]，在授权成功后可直接上传；之前 count=0 的根因是登录页，不是上传能力缺失。

推荐排查顺序：

先确认是否真的登录成功
再确认 input[type=file] 是否存在
再确认底部按钮文案是 发布 / 暂存离开 还是其他变体
最后才改 selector

视频发布

1. 打开 creator.douyin.com/creator-micro/content/upload
2. 上传视频文件 (拖拽或点击)
3. 等待上传+转码完成
4. 选择/上传封面
5. 填写描述 + #话题 + @提及
6. 🎵 选择BGM（从推荐/热门中选取适合作品氛围的音乐）
7. 设置：可见性(公开/好友/私密)、合拍、下载
8. 可选：定时发布(最远10天)、POI定位
9. 点击 [发布] 或 [存草稿]

图文发布

1. 打开 creator.douyin.com/creator-micro/content/upload?default-tab=3
2. 上传图片 (2-35张，拖拽排序)
3. 选择封面图
4. 填写描述 + #话题
5. 设置发布选项
6. [发布] 或 [存草稿]

脚本用法

# 0) 冒烟检查（不上传，只打开页面+截图+输出关键信号）
python scripts/publish.py doctor --no-headless \
  --screenshot /tmp/douyin_doctor.png

# 1) 从 daily-content 产物直接发布到草稿箱（推荐，SOP直连）
#   - 支持 md/txt 两种格式：
#     /home/aa/clawd/docs/daily-content/YYYY-MM-DD/douyin/douyin-content-YYYY-MM-DD.md
#     /home/aa/clawd/docs/daily-content/YYYY-MM-DD/douyin/douyin-3posts-YYYY-MM-DD.txt
#   - pick=1/2/3 选择第几条
#   - 默认 mode=draft（只存草稿）
python scripts/publish.py daily \
  --source "/home/aa/clawd/docs/daily-content/2026-03-24/douyin/douyin-content-2026-03-24.md" \
  --pick 1 \
  --type image \
  --files "/path/to/img1.jpg,/path/to/img2.jpg" \
  --mode draft

# 2) 视频发布（草稿模式）
python scripts/publish.py video \
  --file "/path/to/video.mp4" \
  --title "可选标题（≤55字）" \
  --desc "描述文字 #话题1 #话题2" \
  --cover "/path/to/cover.jpg" \
  --mode draft

# 3) 图文发布
python scripts/publish.py image \
  --files "/path/to/img1.jpg,/path/to/img2.jpg" \
  --title "可选标题（≤55字）" \
  --desc "图文描述 #话题1" \
  --mode draft

# 4) 定时发布（⚠️仅在 Daniel 明确确认后使用 publish）
python scripts/publish.py daily \
  --source "/home/aa/clawd/docs/daily-content/2026-03-25/douyin/douyin-3posts-2026-03-25.txt" \
  --pick 2 \
  --type video \
  --file "/path/to/video.mp4" \
  --schedule "2026-03-27 21:30" \
  --mode publish

UI 选择器参考（React SPA，类名含hash）

元素	定位策略	说明
上传区域	`input[type="file"]` / `button:has-text("上传视频")`	文件上传；先确认已登录，未登录时可能为 0
描述输入	`[class="desc"] [contenteditable]` / `textarea` / `[placeholder="添加作品描述"]`	描述编辑区
话题输入	描述区中输入 `#` 触发话题搜索	话题弹窗选择
封面选择	`[class*="cover"]` / 封面编辑弹窗	视频帧或自定义
音乐选择	`添加音乐` 按钮 / 音乐搜索面板	从推荐/热门中选择BGM
发布按钮	`button:has-text("发布")`	发布确认
草稿按钮	`button:has-text("存草稿")` / `button:has-text("暂存离开")`	当前实测图文页常见为 `暂存离开`
定时开关	`[class*="schedule"]` / 时间选择器	定时发布
可见性	`[class*="permission"]` / radio按钮	公开/好友/私密
图片排序	拖拽操作	调整图片顺序

注意：抖音使用React + CSS Modules，class名含hash前缀，优先用文本匹配(has-text)或placeholder定位。

发布时间建议

时段	推荐度	说明
7:00-9:00	⭐⭐⭐	早通勤
11:30-13:00	⭐⭐⭐	午休
17:30-19:00	⭐⭐⭐	下班通勤
20:00-22:00	⭐⭐⭐⭐⭐	晚间黄金档
22:00-00:00	⭐⭐⭐⭐	睡前

错误处理

错误	处理
登录过期	提示扫码，`--headless false`
滑块验证	暂停等待手动完成
上传超时	重试3次，指数退避(10s/30s/90s)
转码失败	检查格式/分辨率，降级重传
描述过长	截断到200字并警告
频率限制	建议每天≤3条，间隔≥30分钟

算法要点

发布后2小时内"赛马机制"决定推荐量
完播率 > 点赞率 > 评论率 > 转发率
前3秒决定用户是否继续观看
话题标签影响推荐池分配
竖屏内容推荐权重更高

发布前检查清单

描述 ≤200字，含3-5个话题标签
视频：MP4/WebM格式，≤16GB，≤60分钟
图文：2-35张，JPG/PNG/WebP，每张≤50MB
封面清晰，竖版9:16最优
无其他平台水印
AI内容已标注（如适用）
非搬运内容
已截图回传确认
若使用 daily 模式：已核对 pick 对应的是正确那条内容

文件结构

douyin-smart-publish/
├── SKILL.md
├── scripts/
│   └── publish.py          # Playwright 自动发布脚本
├── references/
│   └── platform-rules.md   # 完整平台规则
└── templates/
    └── desc-template.md    # 描述/话题排版模板

🎵 选择BGM（音乐选择步骤）

在填写完描述后、存草稿前执行。

操作流程

1. 在发布页面找到"添加音乐"按钮（通常在描述区下方）
2. 点击打开音乐选择面板
3. 切换到"推荐"或"热门"标签页
4. 搜索与作品内容匹配的音乐（搜索关键词参考下方匹配表）
5. 试听前10秒，判断节奏和氛围是否贴合
6. 选择合适音乐 → 点击"使用"

浏览器操作（OpenClaw Browser）

# 找到并点击"添加音乐"按钮
browser(action="act", kind="evaluate", targetId=编辑页targetId, fn="""
  () => {
    const btns = document.querySelectorAll('button, div, span');
    for (const btn of btns) {
      const text = btn.textContent.trim();
      if (text === '添加音乐' || text === '选择音乐' || text.includes('音乐')) {
        if (btn.offsetParent !== null) {
          btn.click();
          return 'clicked: ' + text;
        }
      }
    }
    return 'not found';
  }
""")

# 等待音乐面板加载
browser(action="act", kind="wait", timeMs=2000)

# 切换到"推荐"或"热门"标签
browser(action="act", kind="evaluate", targetId=编辑页targetId, fn="""
  () => {
    const tabs = document.querySelectorAll('div, span, button');
    for (const tab of tabs) {
      const text = tab.textContent.trim();
      if ((text === '推荐' || text === '热门') && tab.offsetParent !== null) {
        tab.click();
        return 'switched to: ' + text;
      }
    }
    return 'not found';
  }
""")

# 搜索匹配音乐（根据内容主题）
browser(action="act", kind="evaluate", targetId=编辑页targetId, fn="""
  () => {
    const input = document.querySelector('input[placeholder*="搜索音乐"]');
    if (input) {
      input.value = '{搜索关键词}';
      input.dispatchEvent(new Event('input', { bubbles: true }));
      return 'searched';
    }
    return 'search input not found';
  }
""")

内容×BGM 搜索关键词匹配

内容类型	推荐搜索关键词	风格方向
AI/科技	"科技感" "电子" "赛博朋克"	节奏感强、未来感
编程/技术	"轻音乐" "lofi" "学习"	舒适、不干扰
行业分析	"商务" "沉稳" "大气"	专业、可信
对比评测	"节奏" "悬念" "动感"	起伏感、吸引注意力
工具推荐	"轻快" "活力" "阳光"	积极、轻快
深度解读	"史诗" "电影感" "沉浸"	大气、有层次

选择策略

优先级：
1. 推荐列表前5首中找风格匹配的 → 直接使用
2. 热门榜前10首中找风格匹配的 → 直接使用
3. 搜索关键词后选播放量最高的 → 使用
4. 都不合适 → 跳过音乐选择（不强制）

注意事项

只从抖音音乐库选择（自动获授权，无版权风险）
不要上传本地音频（可能侵权）
优先选推荐的（算法推荐 = 当前热门 = 更高曝光）
试听前10秒（判断节奏是否贴合内容节奏）
不合适就跳过（宁可没有BGM也不用不搭的音乐）

更新日志

v1.2.0 (2026-04-16): 新增BGM选择步骤
- 发布流程Step 6: 选择BGM（从推荐/热门中选取）
6种内容类型×BGM搜索关键词匹配
OpenClaw Browser音乐面板操作代码
UI选择器新增"音乐选择"条目
v1.1.0 (2026-04-16): 安全增强
- Pre-flight checklist（浏览器、登录态、文件、doctor 冒烟测试）
- Safety screenshots（6个关键节点截图）
- Error escalation（3次失败即停止）
- Recovery mode 文档
- 草稿按钮文案变体文档（存草稿/暂存离开/草稿）
v1.0.0 (2026-03-27): 初始版本，实战验证通过

name	douyin-smart-publish
description	抖音创作者平台智能发布（视频/图文）：内容适配→上传→填描述/#话题→封面→存草稿→截图回传确认。默认只存草稿；只有在 Daniel 明确确认后才允许点击发布。覆盖标题(≤55字)、描述(建议≤200字)、#话题标签(3-5个)、封面设置、定时发布、可见性、合拍/下载开关。Playwright 自动化。触发：'发抖音'、'抖音发布'、'douyin publish'、'抖音图文'、'抖音视频'、'发布短视频'。
author	Daniel Li
version	1.1.0

douyin-smart-publish

More from this repository

More from this repository

抖音智能发布 v1.1

⚠️ 默认发布策略

⚡ v1.1 安全增强

Pre-flight Checklist（飞行前检查）

Safety Screenshots（安全截图）

Error Escalation（错误升级规则）

恢复模式（Recovery）

草稿按钮文案变体

平台入口

发布类型

排版规则

视频规范

图文规范

描述/标题规范

封面规范

AIGC标注要求（2023.9起）

内容适配模板

发布流程

关键安全门：截图确认 → 再发布

2026-03-27 实战验证结论（已跑通）

视频发布

图文发布

脚本用法

UI 选择器参考（React SPA，类名含hash）

发布时间建议

错误处理

算法要点

发布前检查清单

文件结构

🎵 选择BGM（音乐选择步骤）

操作流程

浏览器操作（OpenClaw Browser）

内容×BGM 搜索关键词匹配

选择策略

注意事项

更新日志

抖音智能发布 v1.1

⚠️ 默认发布策略

⚡ v1.1 安全增强

Pre-flight Checklist（飞行前检查）

Safety Screenshots（安全截图）

Error Escalation（错误升级规则）

恢复模式（Recovery）

草稿按钮文案变体

平台入口

发布类型

排版规则

视频规范

图文规范

描述/标题规范

封面规范

AIGC标注要求（2023.9起）

内容适配模板

发布流程

关键安全门：截图确认 → 再发布

2026-03-27 实战验证结论（已跑通）

视频发布

图文发布

脚本用法

UI 选择器参考（React SPA，类名含hash）

发布时间建议

错误处理

算法要点

发布前检查清单

文件结构

🎵 选择BGM（音乐选择步骤）

操作流程

浏览器操作（OpenClaw Browser）

内容×BGM 搜索关键词匹配

选择策略

注意事项

更新日志