Douyin MCP Server

★ 1,200

from yzfly

Extract watermark-free video links and copy from Douyin.

🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys

#email #git #video-editing

短视频文案提取器

从短视频分享链接下载无水印视频，AI 自动提取语音文案。

✨ 功能特性

🎬 无水印视频 - 获取高质量无水印视频下载链接
🎙️ AI 语音识别 - 使用硅基流动 SenseVoice 自动提取文案
📑 大文件支持 - 自动分段处理超过 1 小时或 50MB 的音频
🌐 WebUI - 现代化浏览器界面，无需命令行
🔌 MCP 集成 - 支持 Claude Desktop 等 AI 应用

📦 使用方式

方式适用场景特点 WebUI 普通用户浏览器操作，最简单 MCP Server Claude Desktop 用户 AI 对话中直接调用 命令行 开发者批量处理，脚本集成

🌐 WebUI (推荐)

最简单的使用方式，打开浏览器即可使用。

快速开始

Copy & paste — that's it

# 1. 克隆项目
git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-server

# 2. 安装依赖
uv sync

# 3. 启动服务
uv run python web/app.py

打开浏览器访问 http://localhost:8080

配置 API Key

有两种方式配置 API Key：

方式一：浏览器内配置（推荐）

打开 WebUI 页面
点击顶部的「API 未配置」按钮
在弹窗中输入 API Key 并保存
API Key 保存在浏览器本地，刷新页面后仍有效

方式二：环境变量

Copy & paste — that's it

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 配置文件，添加：

Copy & paste — that's it

{
 "mcpServers": {
 "douyin-mcp": {
 "command": "uvx",
 "args": ["douyin-mcp-server"],
 "env": {
 "API_KEY": "sk-xxxxxxxxxxxxxxxx"
 }
 }
 }
}

可用工具

工具名功能需要 API parse_douyin_video_info 解析视频信息 ❌ get_douyin_download_link 获取下载链接 ❌ extract_douyin_text 提取视频文案 ✅

对话示例

Copy & paste — that's it

用户：帮我提取这个视频的文案 https://v.douyin.com/xxxxx/

Claude：我来帮你提取视频文案...
[调用 extract_douyin_text 工具]
提取完成，文案内容如下：
...

🛠️ 命令行工具

适合开发者和批量处理场景。

安装

Copy & paste — that's it

git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-server
uv sync

命令说明

Copy & paste — that's it

# 查看帮助
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

输出格式

Copy & paste — that's it

output/
└── 7600361826030865707/
 ├── transcript.md # 文案文件
 └── *.mp4 # 视频文件（可选）

transcript.md 内容：

Copy & paste — that's it

# 视频标题

| 属性 | 值 |
|------|-----|
| 视频ID | `7600361826030865707` |
| 提取时间 | 2026-01-30 14:19:00 |
| 下载链接 | [点击下载](url) |

---

## 文案内容

这里是 AI 识别的语音文案...

📋 系统要求

依赖说明安装方式 uv Python 包管理 curl -LsSf https://astral.sh/uv/install.sh | sh Python 3.10+ uv python install 3.12 FFmpeg 音视频处理 brew install ffmpeg (macOS) apt install ffmpeg (Ubuntu)

🔧 技术说明

大文件处理

当音频文件超过 API 限制时（1 小时或 50MB），自动执行：

检测音频时长和文件大小
使用 FFmpeg 分割成 9 分钟的片段
逐段调用 API 转录
合并所有文本结果

API 说明

语音识别使用硅基流动 SenseVoice API：

模型：FunAudioLLM/SenseVoiceSmall
限制：单次最大 1 小时 / 50MB（已自动处理）
费用：新用户有免费额度

📝 更新日志

v1.4.0 (最新)

🌐 WebUI - 新增浏览器可视化界面
🔑 浏览器配置 API Key - 无需环境变量
📑 大文件支持 - 自动分段处理长音频

v1.3.0

✨ Claude Code Skill 支持
📄 Markdown 格式输出

v1.2.0

🔄 API 升级

v1.0.0

🎉 首次发布

⚠️ 免责声明

本项目仅供学习和研究使用
使用者需遵守相关法律法规
禁止用于侵犯知识产权的行为
作者不对使用本项目产生的损失承担责任

📄 许可证

Apache License 2.0

👨‍💻 作者

yzfly - GitHub | Email

Copy & paste — that's it

# 1. 克隆项目
git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-server

# 2. 安装依赖
uv sync

# 3. 启动服务
uv run python web/app.py

Before it works, you'll need: API_KEY