Douyin Upload MCP Skill

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

Douyin Upload MCP Skill

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

English | 中文

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

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 工具列表

核心发布

登录与状态

页面操作

登录流程

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

配置

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

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

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

浏览器配置

Daemon 配置

其他配置

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