Skip to main content
Glama
WJZ-P

douyin-upload-mcp-skill

by WJZ-P
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

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

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/WJZ-P/douyin-upload-mcp-skill'

If you have feedback or need assistance with the MCP directory API, please join our Discord server