内容
# 抖音 MCP 服务器
用于需要解析抖音分享链接并提取有用视频元数据的 AI 代理的 MCP 服务器。
它专注于实用的短视频工作流程：收集资产、理解视频元数据以及帮助代理处理抖音/TikTok 风格的内容链接。
## 功能
- 解析抖音短分享链接
- 解析重定向的视频页面
- 提取标题、作者、时长、封面图片、音乐和视频 URL
- 尝试在可用时返回无水印视频 URL
- 提供 TikTok 热门检索支持
## 工具
| 工具 | 描述 |
| --- | --- |
| `parse_douyin` | 解析抖音分享链接并提取视频信息和媒体 URL |
| `get_tiktok_trending` | 获取全球 TikTok 热门视频列表 |
## 适用场景
- 短视频资产收集
- AI 辅助视频研究
- 内容再利用工作流程
- 创作者研究和参考资料收集
- 需要结构化视频元数据的代理工作流程
## 安装
```bash
pip install git+https://github.com/521w/douyin-mcp.git
```
或从源代码安装：
```bash
git clone https://github.com/521w/douyin-mcp.git
cd douyin-mcp
pip install -e .
```
## MCP 配置
```json
{
"mcpServers": {
"douyin": {
"command": "python3",
"args": ["-m", "douyin_mcp.server"]
}
}
}
```
## 示例
输入：
```json
{
"share_url": "https://v.douyin.com/xxxxx/"
}
```
输出包括：
```text
标题
作者
时长
封面图片 URL
视频 URL
音乐 URL
```
## 示例代理任务
- "解析此抖音链接并总结视频元数据。"
- "从此分享链接中提取封面、音乐和视频 URL。"
- "从一批短视频链接中收集参考资料。"
- "帮助我从抖音链接中建立内容灵感板。"
## 为什么选择此服务器
- **代理就绪**：将凌乱的分享链接转换为结构化元数据
- **实用**：对创作者工作流程和内容运营有帮助
- **小且专注**：一项任务，易于插入更大的代理管道中
- **可产品化**：可以成为内容研究、剪辑或混剪工作流程的一部分
## 要求
- Python >= 3.9
- `mcp >= 1.0.0`
- `requests >= 2.28.0`
## 注意事项
抖音和 TikTok 端点可能会更改或阻止自动访问。此服务器应被视为一个实用的集成层，可能需要在平台更新其行为时进行维护。
下载或重用媒体时，请尊重平台规则和版权。
## 验证状态
在 Termux/Android 上使用 Python 3.13 验证：
```bash
python -m venv .venv
. .venv/bin/activate
pip install -e .
douyin-mcp
```
MCP 初始化和工具列表验证成功。`get_tiktok_trending` 在 TikTok 重置连接时返回了处理的平台/网络故障，因此实时端点可用性可能会有所不同。
## 许可证
MIT
