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

Douyin Upload MCP Skill

快速开始 · 报告 Bug · 提出新特性

English | 中文

抖音自动发布示例

▲ 通过 MCP 工具全自动发布视频和图文

douyin-upload-mcp-skill

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

功能

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

快速开始

1. 安装依赖

hljs language-bash

npm install

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

在 MCP 客户端配置中添加：

hljs language-json

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

或手动启动：

hljs language-bash

npm run mcp

3. 运行 Demo 测试

hljs language-bash

# 视频发布
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 推进：

hljs language-yaml

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

架构

hljs language-arduino

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：

hljs language-env

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 社区

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

Douyin Upload MCP Skill

快速开始 · 报告 Bug · 提出新特性

English | 中文

抖音自动发布示例

▲ 通过 MCP 工具全自动发布视频和图文

douyin-upload-mcp-skill

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

功能

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

快速开始

1. 安装依赖

hljs language-bash

npm install

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

在 MCP 客户端配置中添加：

hljs language-json

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

或手动启动：

hljs language-bash

npm run mcp

3. 运行 Demo 测试

hljs language-bash

# 视频发布
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 推进：

hljs language-yaml

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

架构

hljs language-arduino

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：

hljs language-env

BROWSER_DEBUG_PORT=18800

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

技术栈

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

License

AGPL-3.0

LINUX DO

本项目支持 LINUX DO 社区

douyin-upload-mcp-skill

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

Douyin Upload MCP Skill

douyin-upload-mcp-skill

功能

快速开始

1. 安装依赖

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

3. 运行 Demo 测试

MCP 工具列表

核心发布

登录与状态

页面操作

登录流程

架构

配置

浏览器配置

Daemon 配置

其他配置

关于 OpenClaw 浏览器复用

技术栈

License

LINUX DO

Similar Packages

douyin-upload-mcp-skill

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

Douyin Upload MCP Skill

douyin-upload-mcp-skill

功能

快速开始

1. 安装依赖

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

3. 运行 Demo 测试

MCP 工具列表

核心发布

登录与状态

页面操作

登录流程

架构

配置

浏览器配置

Daemon 配置

其他配置

关于 OpenClaw 浏览器复用

技术栈

License

LINUX DO

Similar Packages