📦
Douyin MCP
Enables automated Douyin video uploads and account management using Playwright for browser simulation. It supports QR code login, cookie persistence, and automated metadata handling for publishing videos through natural language or API commands.
0 installs
Trust: 34 — Low
Devtools
Ask AI about Douyin MCP
Powered by Claude · Grounded in docs
I know everything about Douyin MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Douyin MCP (Playwright 版)
基于 Playwright 模拟浏览器操作实现的抖音 (Douyin) MCP 服务器,支持视频上传功能。
特性
- ✅ 扫码登录 - 使用抖音 App 扫码登录
- ✅ 视频上传 - 模拟浏览器操作上传视频
- ✅ 自动填表 - 自动填写标题、简介、标签
- ✅ Cookie 持久化 - 登录状态自动保存
- ✅ HTTP API - 提供 RESTful API 接口
目录结构
douyin-mcp/
├── server-playwright.js # MCP HTTP 服务器 (端口 18062)
├── login-playwright.js # 扫码登录工具
├── package.json # 依赖配置
├── cookies.json # 登录状态 (自动生成)
└── README.md # 使用文档
安装
cd douyin-mcp
npm install
Playwright 浏览器会自动安装。
使用方法
1. 登录抖音
# 在 douyin-mcp 目录
npm run login
# 或
node login-playwright.js
运行后会打开浏览器窗口,显示二维码:
- 打开抖音 App
- 点击右上角扫描图标
- 扫描浏览器中的二维码
- 在手机上确认登录
登录成功后会自动保存 cookies。
2. 启动 MCP 服务器
# 在 douyin-mcp 目录
npm start
# 或
node server-playwright.js
服务器运行在 http://localhost:18062
3. 发布视频
使用 curl 调用 API:
curl -X POST http://localhost:18062/api/v1/publish \
-H "Content-Type: application/json" \
-d '{
"title": "视频标题",
"content": "视频简介",
"video_path": "/path/to/video.mp4",
"tags": ["标签 1", "标签 2"],
"visibility": "public"
}'
API 接口
健康检查
GET http://localhost:18062/health
检查登录状态
GET http://localhost:18062/api/v1/login/status
获取登录二维码
GET http://localhost:18062/api/v1/login/qrcode
发布视频
POST http://localhost:18062/api/v1/publish
Content-Type: application/json
{
"title": "视频标题",
"content": "视频简介",
"video_path": "/path/to/video.mp4",
"tags": ["标签 1", "标签 2"],
"visibility": "public"
}
参数说明:
title- 视频标题content- 视频简介video_path- 本地视频文件绝对路径tags- 标签数组visibility- public(公开) 或 private(私密)
配置 MCP Client
在 MCP 配置中添加:
{
"mcpServers": {
"douyin": {
"command": "node",
"args": ["/path/to/douyin-mcp/server-playwright.js"]
}
}
}
常见问题
1. 登录过期
抖音 cookies 有一定的有效期,如果发布时提示未登录,需要重新运行登录工具:
node login-playwright.js
2. 浏览器窗口
- 登录时会显示浏览器窗口(方便扫码)
- 上传视频时无头模式运行(不显示窗口)
技术栈
- Playwright - 浏览器自动化
- Express - HTTP 服务器
- Node.js - 运行环境
参考
- 小红书 MCP - 灵感来源
- Playwright 文档
- 抖音创作者服务平台
License
MIT
注意
本项目仅供学习和个人使用,请遵守抖音的使用条款和社区规范。
