基于 CDP 操控抖音创作者平台，实现视频、图文的全自动发布。

douyin-upload-mcp-skill

基于 CDP（Chrome DevTools Protocol）的抖音创作者平台自动化上传服务，通过 MCP 协议对外暴露工具，支持视频和图文的全自动发布。

功能

视频发布：上传视频 → 等待转码 → AI 封面推荐 → 填写标题/简介 → 一键发布
图文发布：上传多张图片 → 填写标题/简介 → 自动选择音乐 → 一键发布
登录管理：扫码 → 短信验证 → 验证码输入，全流程自动推进
浏览器托管：独立 Daemon 进程管理 Chrome 生命周期，闲置 30 分钟自动销毁

快速开始

1. 安装依赖

npm install

2. 作为 MCP 服务使用（推荐）

在 MCP 客户端配置中添加：

{
  "mcpServers": {
    "douyin": {
      "command": "node",
      "args": ["<项目绝对路径>/src/mcp-server.js"]
    }
  }
}

或手动启动：

npm run mcp

3. 运行 Demo 测试

# 视频发布
node src/demo.js

# 图文发布
node src/demo-imagetext.js

MCP 工具列表

核心发布

工具	说明	必填参数	可选参数
`douyin_publish_video`	发布视频	`filePath`	`title`, `description`, `timeout`
`douyin_publish_imagetext`	发布图文	`filePaths`	`title`, `description`

登录与状态

工具	说明	可选参数
`douyin_check_login`	检查登录状态并推进登录流程	`smsCode`
`douyin_probe`	探测页面元素状态	—
`douyin_screenshot`	页面截图	—

页面操作

工具	说明	参数
`douyin_navigate_to`	导航到指定抖音 URL	`url`, `timeout`
`douyin_reload_page`	刷新页面	`timeout`
`douyin_browser_info`	获取浏览器连接信息	—

登录流程

MCP 不支持中途交互，登录需要多次调用 douyin_check_login 推进：

第 1 次调用 → phase: qrcode           → 截图保存二维码，用户扫码
第 2 次调用 → phase: sms_verification → 自动点击「接收短信验证码」
第 3 次调用 → phase: sms_code_input   → 提示输入验证码
第 4 次调用 → phase: logged_in        → 传入 smsCode 完成登录

架构

MCP Client → mcp-server.js → index.js → browser.js → Daemon
                                ↓
                          douyin-ops.js → operator.js → CDP → Chrome → douyin.com

层	文件	职责
协议层	`mcp-server.js`	MCP 工具注册，stdio 传输
入口层	`index.js`	对外暴露 `createDouyinSession()`
业务层	`douyin-ops.js`	抖音业务编排（上传、填写、发布）
原子层	`operator.js`	CDP 底层操作（locate/click/type），带人类行为模拟
连接层	`browser.js`	连接 Daemon 获取浏览器实例
Daemon	`daemon/`	独立进程管理浏览器生命周期

配置

所有配置通过环境变量或 .env 文件设置。项目根目录已提供 .env 模板，可直接修改。

配置优先级： process.env > .env.development > .env > 代码默认值

.env.development 不会被 git 追踪，适合存放本地私有配置（如浏览器路径）。

浏览器配置

变量	默认值	说明
`BROWSER_PATH`	自动检测	浏览器可执行文件路径，支持 Chrome / Edge / Chromium。不设则自动按优先级检测系统已安装的浏览器
`BROWSER_DEBUG_PORT`	`40821`	CDP 远程调试端口。多个 skill（如 gemini-skill）共享同一端口即共享同一浏览器实例
`BROWSER_HEADLESS`	`false`	是否无头模式。首次使用建议关闭（`false`），方便扫码登录
`BROWSER_USER_DATA_DIR`	`~/.wjz_browser_data`	浏览器用户数据目录，保存登录态、cookies 等。首次运行会自动从系统默认浏览器目录克隆
`BROWSER_PROTOCOL_TIMEOUT`	`60000`	CDP 协议超时时间（毫秒）。视频上传等长操作可适当增大

Daemon 配置

变量	默认值	说明
`DAEMON_PORT`	`40225`	Daemon HTTP 服务端口。与 gemini-skill 共享同一 Daemon
`DAEMON_TTL_MS`	`1800000`	闲置超时时间（毫秒），默认 30 分钟。超时后自动关闭浏览器并退出 Daemon，下次调用时自动重新拉起

其他配置

变量	默认值	说明
`OUTPUT_DIR`	`./douyin-output`	截图、二维码等输出文件目录
`DOUYIN_URL`	`https://creator.douyin.com/`	抖音创作者平台首页 URL

关于 OpenClaw 浏览器复用

OpenClaw 的默认 CDP 端口是 18800。如果你希望复用 OpenClaw 已启动的浏览器会话，可以将 BROWSER_DEBUG_PORT 改为 18800：

BROWSER_DEBUG_PORT=18800

但请注意：OpenClaw 自带的浏览器会话没有集成 Stealth 反爬插件，在反检测能力上不如本项目自行维护的浏览器实例。本项目使用 puppeteer-extra-plugin-stealth 提供了完整的反爬保护（隐藏 webdriver 标记、模拟真实浏览器指纹等），能更好地规避抖音平台的自动化检测。

建议：除非有特殊需求，推荐使用默认端口 40821，让项目自行管理浏览器实例以获得最佳的反爬效果。

技术栈

puppeteer-core + puppeteer-extra-plugin-stealth：CDP 连接 + 反检测
@modelcontextprotocol/sdk：MCP 协议实现
原生 Node.js HTTP：Daemon 微服务

License

AGPL-3.0

LINUX DO

本项目支持 LINUX DO 社区