Content
[This is a Chinese README. English translation is not available yet.]
# 抖音无水印视频文本提取 MCP 服务器
[](https://badge.fury.io/py/douyin-mcp-server)
[](https://pypi.org/project/douyin-mcp-server/)
[](https://opensource.org/licenses/Apache-2.0)
一个基于 Model Context Protocol (MCP) 的服务器，可以从抖音分享链接下载无水印视频，提取音频并转换为文本。
<a href="https://glama.ai/mcp/servers/@yzfly/douyin-mcp-server">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@yzfly/douyin-mcp-server/badge" alt="douyin-mcp-server MCP server" />
</a>
## 📋 项目声明
**官方文档地址：** https://github.com/yzfly/douyin-mcp-server
请以本项目的 [README.md](https://github.com/yzfly/douyin-mcp-server/blob/main/README.md) 文件为准，了解项目的功能特性、使用方法、API 配置说明等详细信息。
**重要提醒：** 第三方平台如因自身 MCP Server 功能支持度限制而无法正常使用，请联系相应平台方。本项目不提供任何形式的技术支持或保证，用户需自行承担使用本项目可能产生的任何损失或损害。
**法律声明：**
1. 本项目基于 Apache 2.0 协议发布
2. 本项目仅供学习和研究使用，不得用于任何违法或违规目的
3. 本项目的使用必须遵守相关法律法规
4. 本项目的作者和贡献者不对项目的任何部分承担法律责任
## ✨ 功能特性
- 🎵 **无水印视频获取** - 从抖音分享链接获取高质量无水印视频
- 🎧 **智能音频提取** - 自动从视频中提取音频内容
- 📝 **AI 文本识别** - 使用先进的语音识别技术提取文本内容
- 🧹 **自动清理** - 智能清理处理过程中的临时文件
- 🔧 **灵活配置** - 支持自定义 API 配置，默认使用 [阿里云百炼 API](https://help.aliyun.com/zh/model-studio/get-api-key?)
## 🚀 快速开始
### 步骤 1：获取 API 密钥
前往 [阿里云百炼 API](https://help.aliyun.com/zh/model-studio/get-api-key?) 获取您的 `DASHSCOPE_API_KEY`：
### 步骤 2：配置环境变量
在 Claude Desktop、Cherry Studio 等支持 MCP Server 的应用配置文件中添加以下配置：
```json
{
"mcpServers": {
"douyin-mcp": {
"command": "uvx",
"args": ["douyin-mcp-server"],
"env": {
"DASHSCOPE_API_KEY": "sk-xxxx"
}
}
}
}
```
### 步骤 3：开始使用
配置完成后，您就可以在支持的应用中正常调用 MCP 工具了。
## ⚙️ API 配置说明
### 当前版本（>= 1.2.0）
最新版本默认使用阿里云百炼 API，具有以下优势：
- ✅ 识别效果更好
- ✅ 处理速度更快
- ✅ 本地资源消耗更小
**配置步骤：**
1. 前往 [阿里云百炼](https://help.aliyun.com/zh/model-studio/get-api-key?) 开通 API 服务
2. 获取 API Key 并配置到环境变量 `DASHSCOPE_API_KEY` 中
### 旧版本兼容（<= 1.1.0）
如果您需要使用旧版本，请使用以下配置：
```json
{
"mcpServers": {
"douyin-mcp": {
"command": "uvx",
"args": ["douyin-mcp-server@1.1.0"],
"env": {
"DOUYIN_API_KEY": "your-api-key-here"
}
}
}
}
```
**注意：** 旧版本使用硅基流动 API，需要在 [硅基流动](https://cloud.siliconflow.cn/i/TxUlXG3u) 注册账号并获取 API Key。
📖 [1.1.0 版本文档](https://pypi.org/project/douyin-mcp-server/1.1.0/)
## 🛠️ 工具说明
### `get_douyin_download_link`
获取抖音视频的无水印下载链接。
**参数：**
- `share_link` (string): 抖音分享链接或包含链接的文本
**返回：**
- JSON 格式的下载链接和视频信息
**特点：** 无需 API 密钥即可使用
### `extract_douyin_text`
完整的文本提取工具，一站式完成视频到文本的转换。
**处理流程：**
1. 解析抖音分享链接
2. 直接使用视频 URL 进行语音识别
3. 返回提取的文本内容
**参数：**
- `share_link` (string): 抖音分享链接或包含链接的文本
- `model` (string, 可选): 语音识别模型，默认使用 `paraformer-v2`
**环境变量要求：**
- `DASHSCOPE_API_KEY`: 阿里云百炼 API 密钥（必需）
### `parse_douyin_video_info`
轻量级视频信息解析工具。
**参数：**
- `share_link` (string): 抖音分享链接
**特点：** 仅解析视频基本信息，不下载视频文件
### 资源访问
- `douyin://video/{video_id}`: 通过视频 ID 获取详细信息
## 📦 系统要求
### 运行环境
- **Python**: 3.10 或更高版本
### 依赖库
- `requests` - HTTP 请求处理
- `ffmpeg-python` - 音视频处理
- `tqdm` - 进度条显示
- `mcp` - Model Context Protocol 支持
- `dashscope` - 阿里云百炼 API 客户端
## ⚠️ 注意事项
- 🔑 **API 密钥必需**：文本提取功能需要有效的阿里云百炼 API 密钥
- 🆓 **部分功能免费**：获取下载链接功能无需 API 密钥
- 📱 **格式支持**：支持大部分抖音视频格式
- 🚀 **性能优化**：使用阿里云百炼 API 获得更快更准确的识别效果
## 🔧 开发指南
### 本地开发环境搭建
```bash
# 克隆项目
git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-server
# 安装依赖（开发模式）
pip install -e .
```
### 运行测试
```bash
# 启动服务器进行测试
python -m douyin_mcp_server.server
```
### Claude Desktop 本地开发配置
在 Claude Desktop 配置文件中添加本地开发配置：
```json
{
"mcpServers": {
"douyin-mcp": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/your/douyin-mcp-server",
"python",
"-m",
"douyin_mcp_server"
],
"env": {
"DASHSCOPE_API_KEY": "your-api-key-here"
}
}
}
}
```
## ⚠️ 免责声明
### 使用风险
- 使用者对本项目的使用完全自主决定，并自行承担所有风险
- 作者对使用者因使用本项目而产生的任何损失、责任或风险概不负责
### 代码质量
- 本项目基于现有知识和技术开发，作者努力确保代码的正确性和安全性
- 但不保证代码完全没有错误或缺陷，使用者需自行评估和测试
### 第三方依赖
- 本项目依赖的第三方库、插件或服务遵循各自的开源或商业许可
- 使用者需自行查阅并遵守相应协议
- 作者不对第三方组件的稳定性、安全性及合规性承担责任
### 法律合规
- 使用者必须自行研究相关法律法规，确保使用行为合法合规
- 任何违反法律法规导致的法律责任和风险，均由使用者自行承担
- 禁止使用本工具从事任何侵犯知识产权的行为
- 开发者不参与、不支持、不认可任何非法内容的获取或分发
### 数据处理
- 本项目不对使用者的数据收集、存储、传输等处理活动的合规性承担责任
- 使用者应自行遵守相关法律法规，确保数据处理行为合法正当
### 责任限制
- 使用者不得将项目作者、贡献者或相关方与使用行为联系起来
- 不得要求作者对使用项目产生的任何损失或损害负责
- 基于本项目的二次开发、修改或编译程序与原作者无关
### 知识产权
- 本项目不授予使用者任何专利许可
- 若使用本项目导致专利纠纷或侵权，使用者自行承担全部风险和责任
- 未经书面授权，不得用于商业宣传、推广或再授权
### 服务终止
- 作者保留随时终止向违反声明的使用者提供服务的权利
- 可能要求违规使用者销毁已获取的代码及衍生作品
- 作者保留在不另行通知的情况下更新本声明的权利
**⚠️ 重要提醒：在使用本项目前，请认真阅读并完全理解上述免责声明。如有疑问或不同意任何条款，请勿使用本项目。继续使用即视为完全接受上述声明并自愿承担所有风险和后果。**
## 📄 许可证
Apache License 2.0
## 👨💻 作者
- **yzfly** - [yz.liu.me@gmail.com](mailto:yz.liu.me@gmail.com)
- GitHub: [https://github.com/yzfly](https://github.com/yzfly)
## 🤝 贡献
欢迎提交 Issue 和 Pull Request！我们期待您的参与和贡献。
## 📝 更新日志
### v1.2.0 (最新)
- 🚀 **性能提升**：更快、更准确的视频文案提取
- 🔄 **API 升级**：切换到阿里云百炼 API，显著提升识别准确率
- 🔧 **配置更新**：环境变量从 `DOUYIN_API_KEY` 更新为 `DASHSCOPE_API_KEY`
### v1.1.0
- 🐛 **问题修复**：修复提取视频时文件名过长导致的错误
### v1.0.0
- 🎉 **首次发布**：初始版本
- ✨ **核心功能**：支持抖音视频文本提取
- 🔗 **链接获取**：支持获取无水印视频下载链接
- 🔐 **环境配置**：从环境变量读取 API 密钥
- 🧹 **自动清理**：自动清理临时文件
- ⚙️ **灵活配置**：支持自定义 API 配置
