抖音 MCP Skill
⚠️ 操作优先级（必须遵守）
- 🥇 首选：调用 MCP 工具 — 直接调用本 Skill 暴露的 MCP 工具完成操作。绝大多数场景都应该走这条路径。
- 🥈 兜底：运行 Skill 脚本 — 当 MCP 工具无法满足需求时，运行本 Skill 项目中的脚本（如
demo.js、demo-imagetext.js）
- 🥉 最次：连接 Skill 管理的浏览器 — 仅前两种方式都无法解决时，通过
douyin_browser_info 获取 CDP 连接信息接管浏览器。需先征得用户同意
绝对禁止：自行启动新的浏览器实例访问抖音页面。
支持范围
| 类型 | 支持 | 说明 |
|---|
| 发布视频 | ✅ | 上传视频 + 选封面 + 填标题简介 + 发布 |
| 发布图文 | ✅ | 上传图片 + 填标题简介 + 选音乐 + 发布 |
| 发布全景视频 | ❌ | 不支持（场景极少） |
| 发布纯文字 | ❌ | 不支持（场景极少） |
可用 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（仅 douyin.com 域名） | url, timeout |
douyin_reload_page | 刷新页面 | timeout |
douyin_browser_info | 获取浏览器连接信息（兜底接管用） | 无 |
典型使用流程
1. 登录（多次调用 douyin_check_login 推进）
第1次调用 → phase: qrcode → 用户扫码
第2次调用 → phase: sms_verification → 自动点击接收短信
第3次调用 → phase: sms_code_input → 用户告知验证码
第4次调用(smsCode="123456") → phase: logged_in → 登录完成
2. 发布视频
调用 douyin_publish_video:
filePath: "C:/videos/test.mp4"
title: "我的视频"
description: "视频简介 #标签"
3. 发布图文
调用 douyin_publish_imagetext:
filePaths: ["C:/images/1.png", "C:/images/2.png"]
title: "我的图文"
description: "图文简介 #标签"
MCP 客户端配置
{
"mcpServers": {
"douyin": {
"command": "node",
"args": ["<项目绝对路径>/src/mcp-server.js"]
}
}
}
也可通过 npm run mcp 手动启动。
架构
MCP Client → mcp-server.js → index.js → browser.js → Daemon
↓
douyin-ops.js → operator.js → CDP → Chrome → douyin.com
- Daemon（独立进程）：管理浏览器生命周期，闲置 30 分钟自动销毁
- browser.js：Skill 侧连接器，按需自启 Daemon
- operator.js：纯 CDP 底层原子操作
- douyin-ops.js：抖音业务编排层
- mcp-server.js：MCP 工具协议层
端口配置（与 gemini-skill 共享同一浏览器实例）
| 配置项 | 默认值 | 说明 |
|---|
| CDP 端口 | 40821 | 与 gemini-skill 共享 |
| Daemon 端口 | 40225 | 与 gemini-skill 共享 |
多个 skill 共用同一个浏览器实例 + 同一个 Daemon，各 skill 各用各的 tab。
