前言¶
抖音创作中心(creator.douyin.com)是官方发布入口,但页面是 React + Semi Design,封面上传、短信验证、contenteditable 正文等交互很难用一套固定脚本稳定跑通。常见做法是手写 Playwright 或临时录屏,维护成本高,且登录态和弹窗一变就要改代码。
下面介绍 SkillHub 上的社区 Skill @user_401e3080/opencli-douyin(opencli抖音自动化发布内容)。它把 OpenCLI 浏览器自动化与抖音创作中心的实操步骤写进 SKILL.md,让 Agent 按既定命令完成导航、填表、上传与发布,并单独处理 Semi 封面上传和短信验证等坑点。
这是什么¶
一句话定位: 基于 OpenCLI 的抖音创作中心内容发布指南型 Skill,通过已登录浏览器控制 creator.douyin.com,支持文章、图文和视频三类发布流程。
维护与来源: 社区发布者 user_401e3080(SkillHub 页面标注作者为封修九),坐标 @user_401e3080/opencli-douyin,当前版本 1.0.0,分类 business-ops,标签 requires_api_key=false(无需 API Key)。SkillHub 统计:评分 100000,下载 841 次(截至页面展示数据)。
官方入口:
- Skill 地址:https://api.skillhub.cn/user_401e3080/opencli-douyin
- SkillHub 页面:https://www.skillhub.cn/skills/user_401e3080/opencli-douyin
核心功能¶
以下能力均来自 Skill 简介与 SKILL.md 说明:
| 内容类型 | 支持方式 | 说明 |
|---|---|---|
| 图文 | opencli browser 分步操作,或 opencli douyin image-post(需适配器) |
标准图片上传,复杂度相对较低 |
| 文章 | 浏览器分步 + 封面上传专项脚本,或 opencli douyin article |
Semi Design 封面需 monkey-patch 拦截文件 input |
| 视频 | 浏览器上传与等待转码,或 opencli douyin draft 存草稿 |
需较长等待时间 |
自动化侧重点:
- 使用
opencli browser --session dy管理会话(open、state、click、fill、upload、eval、wait)。 - React 表单:
browser fill适用于标题等 input;正文用eval向 contenteditable 注入<p>段落(避免\n成字面量)。 - 文章封面上传:拦截
document.createElement与HTMLInputElement.click,再对带data-oc-cov的 input 执行upload并点「完成」。 - 短信验证:发布可能弹出验证码;
type=number验证码框需用原生valuesetter,不能依赖browser fill。 - 可选 douyin 适配器(放入
~/.opencli/clis/douyin/)后,支持opencli douyin image-post、article、draft等一行式命令。
安装与启用¶
1. 安装本 Skill(SkillHub)¶
SkillHub 页面建议让 AI 按 SkillHub 安装说明 安装坐标包。命令行示例(--dir 须指向当前 Agent 的 skills 目录,否则默认 ./skills/ 可能不被识别):
command -v skillhub && skillhub --version
skillhub install opencli-douyin --namespace user_401e3080 --dir ~/.cursor/skills/
其他客户端常见路径(来自 SkillHub 安装文档):Claude Code 为 ~/.claude/skills/;Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/。将 --dir 换成对应目录即可,安装命令形式相同。
也可向 Agent 发送:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_401e3080/opencli-douyin`。
2. 运行环境(Skill 要求,首次必做)¶
本 Skill 依赖 OpenCLI 生态,按 SKILL.md「环境搭建」顺序配置:
Node.js(>= 21):
node --version
全局安装 OpenCLI:
npm install -g @jackwener/opencli
opencli doctor
Claude Code 侧 OpenCLI 配套 Skill(文档写明 Claude Code 需要这些命令知识):
npx skills add jackwener/opencli
npx skills add opencli-browser
推荐还可安装 opencli-adapter-author、opencli-autofix、opencli-usage;用 npx skills list 核对。
浏览器: 在 Chrome/Chromium 安装 OpenCLI 扩展(商店搜索 OpenCLI,或从 https://github.com/jackwener/opencli/releases 下载扩展 zip 手动加载)。
登录: 在已装扩展的浏览器中打开 https://creator.douyin.com 并完成登录。
可选适配器: 将 article.js、image-post.js 及 _shared/ 放入 ~/.opencli/clis/douyin/(视频草稿 draft.js 文档说明已内置 OpenCLI)。
已知 OpenCLI 1.7.18 问题: 多次 browser upload / fill 可能因 evaluateWithArgs 重复声明 const 报错;SKILL.md 给出修改 @jackwener/opencli 包内 dist/src/browser/base-page.js 的具体补丁,部署前可按文档核对是否仍需要。
典型用法¶
启动会话与图文发布(浏览器分步)¶
会话名 dy 为文档示例。先打开上传页,关弹窗,切 Tab、上传、填标题与正文,最后点发布:
opencli browser --session dy open "https://creator.douyin.com/creator-micro/content/upload"
opencli browser --session dy wait time 3
opencli browser --session dy state
opencli browser --session dy click <N>
opencli browser --session dy upload "input[type=file][accept*=image]" "<图片路径>"
opencli browser --session dy wait time 4
opencli browser --session dy fill "input[placeholder*=填写作品标题]" "<标题>"
正文与「发布」按钮在文档中提供 eval 片段(contenteditable 注入 <p>、查找文案为「发布」的 button)。Windows 下 URL 含 & 可能被 cmd 截断,应使用无查询参数的基础 URL。
文章发布与封面¶
导航到文章页后填标题、正文,封面上传按文档四步:拦截创建 input → upload → 触发 change → 点击「完成」。入口 URL 示例:
opencli browser --session dy open "https://creator.douyin.com/creator-micro/content/post/article"
适配器一行命令(已安装 ~/.opencli/clis/douyin/ 时)¶
opencli douyin image-post "<图片路径>" --title "标题" --caption "正文"
opencli douyin article --title "标题" --content "正文" --cover "<封面路径>"
opencli douyin draft "<视频路径>" --title "标题"
与 Agent 协作¶
安装本 Skill 后,在 Cursor 等环境中用自然语言描述要发的类型、本地素材路径、标题与正文;Agent 应读取 Skill 中的选择器、等待时间与故障表,按需执行 opencli browser 或适配器命令。短信验证步骤需人工提供验证码,Skill 已说明交互顺序。
适用场景与注意¶
适合:
- 已在创作中心有稳定登录态,希望用 Agent + OpenCLI 重复发图文、文章或视频草稿的团队或个人。
- 不想从零维护 Playwright,但需要文档化的 Semi 封面、React 填表与验证流程参考。
- 分类为 business-ops 的运营、内容生产流水线(本 Skill 不提供抖音开放平台 API,而是浏览器自动化)。
限制与注意:
- 强依赖浏览器扩展与登录态;
Extension not connected、Unauthorized等见文档故障表。 - 页面改版会导致 placeholder、Tab 索引变化,需用
opencli browser --session dy state重新定位。 - 发布可能触发短信验证,自动化无法绕过,需人在环。
- 视频需等待上传与转码;文档建议较长
wait time。 - 社区 Skill,版本 1.0.0;升级与签名一致性可用 SkillHub CLI 的
verify等能力自行核对(安装文档有说明)。
结尾¶
opencli抖音自动化发布内容 把抖音创作中心里最费时间的浏览器细节(React 表单、Semi 封面、验证码)收敛成可执行的 OpenCLI 步骤与可选适配器命令,适合作为 Agent 侧的发布 playbook。安装与坐标以 SkillHub 为准:
- https://www.skillhub.cn/skills/user_401e3080/opencli-douyin
- https://api.skillhub.cn/user_401e3080/opencli-douyin