douyin-upload-mcp-skill

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

douyin-upload-mcp-skill

★ 73 Open GitHub ↗

基于浏览器自动化的抖音视频/图文上传 MCP & Skill，适用于openclaw或任何支持skill，mcp的agent. o(￣▽￣)ブ

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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

<h1 align="center">Douyin Upload MCP Skill</h1>

<a href="#快速开始">快速开始</a>
 ·
 <a href="https://github.com/WJZ-P/douyin-upload-mcp-skill/issues">报告 Bug</a>
 ·
 <a href="https://github.com/WJZ-P/douyin-upload-mcp-skill/issues">提出新特性</a>

<a href="./README.en.md">English</a> | 中文

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

# douyin-upload-mcp-skill

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

## 功能

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

## 快速开始

### 1. 安装依赖

```bash
npm install
```

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

在 MCP 客户端配置中添加：

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

或手动启动：

```bash
npm run mcp
```

### 3. 运行 Demo 测试

```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` 推进：

```
第 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](https://github.com/) 的默认 CDP 端口是 **18800**。如果你希望复用 OpenClaw 已启动的浏览器会话，可以将 `BROWSER_DEBUG_PORT` 改为 `18800`：

```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](LICENSE)

## LINUX DO

本项目支持 [LINUX DO](https://linux.do) 社区

douyin-upload-mcp-skill

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README