抖音全类型自动发布:在 Agent 里打通文章、图文与视频发布

前言

抖音创作者平台(creator.douyin.com)的发布表单是 React / Semi Design 界面,上传、话题、配乐、声明和定时往往要反复点选。人工操作一种体裁已经够费神,若还要在文章、图文、视频之间切换,流程和选择器都不相同,很难靠一段固定脚本通吃。

下面介绍 SkillHub 上的社区 Skill「抖音全类型自动发布」(@user_f4e1eca6/douyin-publish-article,v4.0.0)。它把三种体裁的发布步骤写进 SKILL.md,文章路径还提供 douyin-publish.cjs 一键脚本;图文、视频则按文档分步用 Playwright 连浏览器操作。技能说明中记载已在 2026-05-14 至 2026-06-01 期间做多轮真实测试。

这是什么

一句话定位:面向抖音创作者平台的 Agent Skill,覆盖文章、图文、视频三类作品的自动化发布与常见发布选项(话题、配乐、自主声明、定时等)。

来源与维护:SkillHub 社区来源(source: community),发布者坐标 @user_f4e1eca6/douyin-publish-article,SkillHub 页面展示维护者为「叫我老大哥」。当前版本 4.0.0,分类为 content-creation(子类含自媒体运营、短视频脚本)。平台标签 requires_api_key=false,表示不依赖额外 API Key。

官方入口:

  • Skill 安装说明页:https://api.skillhub.cn/user_f4e1eca6/douyin-publish-article
  • SkillHub 详情:https://www.skillhub.cn/skills/user_f4e1eca6/douyin-publish-article

核心功能

以下能力均来自 v4.0.0 的 SKILL.md 与包内脚本说明,按体裁区分实现方式。

体裁 适用场景(文档约定) 发布方式 流程步数
文章 长文,正文 ≤8000 字 douyin-publish.cjs 脚本 8 步
图文 图片 + 文字,描述 ≤1000 字,1–35 张图 浏览器 Playwright 分步 10 步
视频 单文件,≤16GB / ≤60 分钟 浏览器 Playwright 分步 8 步(文档约定跳过手动封面)

跨体裁能力(文档中「通用操作」与各流程章节):

  • 话题:通过创作者页「添加话题」搜索并点选建议项
  • 背景音乐:文章、图文支持按关键词(如「纯音乐」)搜索并「使用」;视频流程文档写明跳过配乐
  • 自主声明:可在弹窗中选择如「内容由AI生成」等项
  • 定时发布:通过「定时发布」与 placeholder="日期和时间" 的输入框设置时间
  • 文章流程另含头图、封面分开上传;图文含从已传图中选封面;视频依赖平台 AI 封面,流程不手动点封面区域

v4.0.0 更新说明(SkillHub API 与 SKILL.md 一致):三合一完整版,分别固化文章脚本路径、图文 10 步、视频 8 步,并附带前提条件与踩坑记录。

安装与启用

1. 安装 SkillHub CLI(若尚未安装)

先检查本机是否已有 CLI:

command -v skillhub && skillhub --version

未安装时,可按 SkillHub 官方安装文档执行(仅 CLI):

curl -fsSL https://skillhub.cn/install/install.sh | bash -s -- --cli-only

完整安装(CLI + 默认 Skill)可使用同文档中的完整安装命令。

2. 安装本 Skill

SkillHub 详情页给出的安装提示为:根据 https://skillhub.cn/install/skillhub.md,安装 @user_f4e1eca6/douyin-publish-article。

在终端中需用 --dir 指向当前 Agent 识别的 skills 目录(装到错误目录会导致 Agent 读不到,文档要求安装后可能还需重启 Agent)。常用路径如下(摘自 SkillHub 安装文档):

环境 skills 目录
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或项目下 .agents/skills/

示例(Cursor):

skillhub install @user_f4e1eca6/douyin-publish-article --dir ~/.cursor/skills/

安装包内含 SKILL.md 与 douyin-publish.cjs(平台签名接口记录该版本 file_count 为 2,外加元数据)。

3. 运行环境(技能硬性前提)

SKILL.md 将 OpenClaw CDP Chrome 列为三类体裁的共用前提:

openclaw browser start
  • CDP 地址:http://127.0.0.1:18800
  • 需在 creator.douyin.com 完成登录(首次扫码;Cookie 持久化,重启后可能需重新登录)

文章一键发布额外要求:Node.js、Playwright(npm 全局),以及可执行的 douyin-publish.cjs。文档示例工作目录为 ~/.openclaw/workspace,实际路径以你部署脚本的位置为准。

图文、视频不强制该 Node 脚本,由 Agent 按 SKILL.md 通过 Playwright 连接上述 CDP 浏览器逐步操作。

典型用法

经过上面的安装与环境准备后,可按体裁选择路径。下列示例字段与命令来自包内 douyin-publish.cjs 与 SKILL.md,仅作结构参考;标题、正文、路径需换成你自己的素材。

文章:改 CONFIG 后脚本发布

  1. 准备头图、封面(文档示例目录 /tmp/openclaw/uploads/)。
  2. 编辑脚本内 CONFIG(节选):
const CONFIG = {
  PUBLISH: true,
  TYPE: 'article',
  TITLE: '标题(≤30字)',
  SUMMARY: '摘要(≤30字)',
  BODY: '<p>正文 HTML</p>',
  TOPICS: ['话题1', '话题2', '话题3'],
  MUSIC_KEYWORD: '纯音乐',
  SCHEDULED_TIME: '2026-06-04 19:00',
  HEADER_IMAGE: '/tmp/openclaw/uploads/article_header.jpg',
  COVER_IMAGE: '/tmp/openclaw/uploads/article_cover.jpg',
};
  1. 在已启动 OpenClaw 浏览器且已登录创作者平台的前提下运行(SKILL.md 示例):
cd ~/.openclaw/workspace
NODE_PATH=~/.npm-global/lib/node_modules node douyin-publish.cjs --type=article --publish

脚本还支持 --type=image、--type=video 等参数(见文件头部注释);图文、视频在文档中更强调分步浏览器流程,与文章「8 步脚本」并列说明。

图文 / 视频:让 Agent 按 SKILL 分步执行

对 Agent 的自然语言需求可围绕体裁说明素材路径与文案,例如:「按 douyin-publish 技能,用已登录的 OpenClaw 浏览器发布一条图文,图片在 /tmp/openclaw/uploads/image_01.jpg…」。Agent 应打开 SKILL.md 中对应章节:

  • 图文:新开 https://creator.douyin.com/creator-micro/content/post/image?type=new&_=<时间戳>,上传 1–35 张图,填标题(≤20 字)与 Slate 描述区,再话题、封面、声明、配乐、定时、发布。
  • 视频:从 https://creator.douyin.com/creator-micro/content/upload 上传文件,等待处理,填标题与描述,添加话题与声明,按文档跳过手动封面与配乐,再定时或立即发布。

连接 CDP 的代码片段在 SKILL.md「连接浏览器」一节,核心为 chromium.connectOverCDP 与 http://127.0.0.1:18800/json/version。

适用场景与注意

更适合谁

  • 已在用 OpenClaw 管理 headed Chrome、并长期在创作者平台发稿的团队或个人
  • 希望把「写稿 + 填表 + 话题/配乐/声明/定时」交给 Agent,且愿意维护 Playwright 与登录态的开发者

限制与坑(摘自技能文档)

  • 强依赖 OpenClaw 浏览器与 CDP 端口;CDP 不通时需 openclaw browser stop && openclaw browser start
  • 图文、视频编辑区为 Slate.js:不宜直接 innerHTML,应使用 keyboard.type 或 execCommand('insertText')
  • 图文打开编辑器建议 URL 加 &_=时间戳,避免草稿残留;配乐侧栏未关闭会挡住「发布」按钮
  • 话题数量有上限(文档记录约 5 个);定时时间只写入 placeholder="日期和时间" 的 input,避免误改标题框
  • 页面 DOM 类名(如 .toolbar-button-spPS4r)随抖音前端迭代可能变化,需结合 SKILL.md 踩坑表维护

SkillHub 公开展示该 Skill 下载约 3180 次(统计会变动);腾讯安全扫描等结果为「安全,无风险」可在详情页查看,安装前仍建议自行审阅 SKILL.md 与脚本,必要时用 skillhub verify douyin-publish-article(需 CLI 版本不低于 2026.7.29,见 SkillHub 验签文档)。

结尾

「抖音全类型自动发布」把文章脚本化、图文与视频浏览器化三条链路写进同一套 Skill,并覆盖话题、配乐(文章/图文)、自主声明与定时等发布侧选项。若你的栈里已有 OpenClaw + 创作者平台登录态,值得把它装进 Agent 的 skills 目录,按体裁查阅 SKILL.md 执行。

  • 安装与说明:https://api.skillhub.cn/user_f4e1eca6/douyin-publish-article
  • SkillHub 详情:https://www.skillhub.cn/skills/user_f4e1eca6/douyin-publish-article
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye