douyin-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@douyin-mcp-server帮我提取这个视频的文案 https://v.douyin.com/xxxxx/"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
短视频文案提取器
从 抖音 / B站 视频分享链接下载音频,AI 自动提取语音文案。
支持多平台视频解析、自动分段并行转录、Docker 一键部署。
✨ 功能特性
🎬 多平台支持 - 同时支持抖音和 B站视频解析
🎙️ AI 语音识别 - 使用硅基流动 SenseVoice 自动提取文案
⚡ 并行转录 - 3 并发分段转录,提速 2-3 倍
🔄 自动重试 - SSL/429 错误自动重试,无需手动干预
📑 大文件支持 - 超过 10 分钟自动分段处理
🐳 Docker 部署 - 一键部署到服务器,自带 FFmpeg
🌐 WebUI - 现代化浏览器界面,无需命令行
🔌 MCP 集成 - 支持 Claude Desktop 等 AI 应用
Related MCP server: douyin-mcp-server
📦 使用方式
方式 | 适用场景 | 特点 |
服务器/云部署 | 一键启动,自带 FFmpeg | |
本地使用 | 浏览器操作 | |
Claude Desktop 用户 | AI 对话中直接调用 | |
开发者 | 批量处理,脚本集成 |
🐳 Docker 部署(最简单)
自带 Python + FFmpeg + yt-dlp,无需安装任何依赖。
Ubuntu 服务器部署步骤
# 1. 安装 Docker(如果还没装)
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# 重新登录让 docker 组生效
# 2. 克隆项目
git clone https://github.com/<your-username>/douyin-mcp-server.git
cd douyin-mcp-server
# 3. 配置 API Key
echo "API_KEY=sk-xxxxxxxxxxxxxxxx" > .env
# 4. 构建并启动(后台运行)
docker compose up -d --build
# 5. 查看运行状态
docker compose logs -f打开浏览器访问 http://服务器IP:8080
一行命令启动(已有 Docker 环境)
docker compose up -d --build配置 API Key
方式一:.env 文件(推荐)
echo "API_KEY=sk-xxxxxxxxxxxxxxxx" > .env方式二:直接传入环境变量
API_KEY=sk-xxxxxxxxxxxxxxxx docker compose up -d --build自定义端口
PORT=9000 docker compose up -d --build访问 http://服务器IP:9000
常用命令
# 查看日志
docker compose logs -f
# 停止服务
docker compose down
# 重新构建(代码更新后)
docker compose up -d --build
# 查看服务状态
docker compose ps🌐 WebUI
本地使用,浏览器操作。
快速开始
# 1. 克隆项目
git clone https://github.com/<your-username>/douyin-mcp-server.git
cd douyin-mcp-server
# 2. 安装依赖
uv sync --extra web
# 3. 启动服务
uv run python web/app.py打开浏览器访问 http://localhost:8080
配置 API Key
有两种方式配置 API Key:
方式一:浏览器内配置(推荐)
打开 WebUI 页面
点击顶部的「API 未配置」按钮
在弹窗中输入 API Key 并保存
API Key 保存在浏览器本地,刷新页面后仍有效
方式二:环境变量
export API_KEY="sk-xxxxxxxxxxxxxxxx"
uv run python web/app.py💡 获取免费 API Key:硅基流动(新用户有免费额度)
功能说明
操作 | 说明 | 需要 API |
获取信息 | 解析视频标题、ID,获取无水印下载链接 | ❌ |
提取文案 | 下载视频 → 提取音频 → AI 语音识别 | ✅ |
下载视频 | 点击下载链接保存无水印视频 | ❌ |
复制/下载文案 | 一键复制或下载 Markdown 格式文案 | - |
使用步骤
粘贴链接 - 将分享链接粘贴到输入框
点击按钮 - 选择「获取信息」或「提取文案」
查看结果 - 右侧显示视频信息和提取的文案
导出 - 复制文案或下载 Markdown 文件
🚀 MCP Server
在 Claude Desktop、Cherry Studio 等支持 MCP 的应用中使用。
配置方法
编辑 MCP 配置文件,添加:
{
"mcpServers": {
"douyin-mcp": {
"command": "uvx",
"args": ["douyin-mcp-server"],
"env": {
"API_KEY": "sk-xxxxxxxxxxxxxxxx"
}
}
}
}💡
API_KEY填写硅基流动的密钥。也兼容旧版配置:设置DASHSCOPE_API_KEY(阿里云百炼密钥)同样可用,两者设其一即可。
可用工具
工具名 | 功能 | 需要 API |
| 解析视频信息 | ❌ |
| 获取下载链接 | ❌ |
| 提取视频文案 | ✅ |
| 识别本地音频文件 | ✅ (百炼) |
| 识别在线音频链接 | ✅ (百炼) |
对话示例
用户:帮我提取这个视频的文案 https://v.douyin.com/xxxxx/
Claude:我来帮你提取视频文案...
[调用 extract_douyin_text 工具]
提取完成,文案内容如下:
...🛠️ 命令行工具
适合开发者和批量处理场景。
安装
git clone https://github.com/<your-username>/douyin-mcp-server.git
cd douyin-mcp-server
uv sync命令说明
# 查看帮助
uv run python douyin-video/scripts/douyin_downloader.py --help
# 获取视频信息(无需 API)
uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a info
# 下载无水印视频
uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a download -o ./videos
# 提取文案(需要 API_KEY)
export API_KEY="sk-xxx"
uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a extract -o ./output
# 提取文案并保存视频
uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a extract -o ./output --save-video输出格式
output/
└── 7600361826030865707/
├── transcript.md # 文案文件
└── *.mp4 # 视频文件(可选)transcript.md 内容:
# 视频标题
| 属性 | 值 |
|------|-----|
| 视频ID | `7600361826030865707` |
| 提取时间 | 2026-01-30 14:19:00 |
| 下载链接 | [点击下载](url) |
---
## 文案内容
这里是 AI 识别的语音文案...📋 系统要求
依赖 | 说明 | 安装方式 |
uv | Python 包管理 |
|
Python | 3.10+ |
|
FFmpeg | 音视频处理 |
|
🔧 技术说明
大文件处理
当音频文件超过 API 限制时(1 小时或 50MB),自动执行:
检测音频时长和文件大小
使用 FFmpeg 分割成 9 分钟的片段
逐段调用 API 转录
合并所有文本结果
API 说明
语音识别使用 硅基流动 SenseVoice API:
模型:
FunAudioLLM/SenseVoiceSmall限制:单次最大 1 小时 / 50MB(已自动处理)
费用:新用户有免费额度
📝 更新日志
v1.4.1 (最新)
🔧 MCP Server 修复 -
API_KEY现在正确对应硅基流动密钥,与文档一致;同时兼容旧版DASHSCOPE_API_KEY配置♻️ 恢复工具 - 恢复
recognize_audio_file/recognize_audio_url工具及extract_douyin_text的context参数🛡️ WebUI 安全加固 - 下载接口不再代理任意 URL,默认仅监听本机
⚡ WebUI 性能 - 提取文案不再阻塞其他请求
📦 依赖精简 - WebUI 依赖改为可选安装(
pip install "douyin-mcp-server[web]")
v1.4.0
🌐 WebUI - 新增浏览器可视化界面
🔑 浏览器配置 API Key - 无需环境变量
📑 大文件支持 - 自动分段处理长音频
v1.3.0
✨ Claude Code Skill 支持
📄 Markdown 格式输出
v1.2.0
🔄 API 升级
v1.0.0
🎉 首次发布
⚠️ 免责声明
本项目仅供学习和研究使用
使用者需遵守相关法律法规
禁止用于侵犯知识产权的行为
作者不对使用本项目产生的损失承担责任
📄 许可证
Apache License 2.0
This server cannot be deployed
Maintenance
Related MCP Connectors
Download YouTube, TikTok, Vimeo, SoundCloud and 6 more platforms from any MCP AI chatbot.
Any video URL to LLM-ready transcript. ASR built in, no captions needed. TikTok, X, TED and more.
Multimodal video analysis MCP — transcription, vision, and OCR for any video URL.
AI speech-to-text for public TikTok videos: SRT, VTT, word timings, speaker labels, 90+ languages.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAn MCP server that downloads videos/extracts audio from various platforms like YouTube, Bilibili, and TikTok, then transcribes them to text using OpenAI's Whisper model.11MIT
- AlicenseAqualityFmaintenance提取抖音无水印视频链接,视频文案,douyin-mcp-server,mcp,claude skill,支持龙虾3309 PyPI1,274Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables downloading watermark-free videos from Douyin (TikTok China) share links, extracting audio, and converting speech to text using AI voice recognition APIs.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables video text extraction using multiple speech recognition providers including local Whisper, JianYing/CapCut, and Bilibili Cut services. Supports video downloading, audio extraction, and automatic speech-to-text transcription with configurable providers.7MIT