MCP Video Download URL Parser
这是一个基于MCP的视频下载工具，支持从抖音、TikTok等平台下载无水印视频。
功能特点
- 支持从抖音、TikTok、哔哩哔哩等平台下载无水印视频
- 使用Playwright模拟浏览器环境，绕过网站的防爬措施
- 自动提取视频标题和下载链接
- 支持自定义下载路径
- 支持作为MCP服务运行
安装依赖
# 安装Python依赖
uv pip install -r requirements.txt
# 安装Playwright浏览器
playwright install
使用方法
作为MCP服务运行
uv run --index-url https://mirrors.aliyun.com/pypi/simple/ main.py
然后可以通过MCP调用download_video函数：
# MCP调用示例
result = await mcp_video_url_parser_download_video(url="https://v.douyin.com/your_video_id/", output_path="D:\\视频")
直接使用测试脚本
# 使用默认测试URL
uv run direct_test.py
# 指定视频URL
uv run direct_test.py "https://v.douyin.com/your_video_id/"
技术实现
本工具使用了两种方式来提取视频URL：
-
Playwright模拟浏览器（主要方法）：
- 完全模拟真实浏览器环境
- 自动访问snapany.com网站
- 输入视频链接并点击提取按钮
- 监听API响应或直接从页面提取视频元素
- 绕过网站的防爬措施，如请求头验证、Cookie验证等
-
API直接请求（备用方法）：
- 直接向snapany.com的API发送请求
- 添加必要的请求头和参数
- 处理多种可能的响应格式
防爬措施解决方案
snapany.com网站有严格的防爬措施，包括：
- 请求头验证：需要特定的请求头，如g-timestamp和g-footer
- Cookie验证：需要有效的会话Cookie
- 浏览器指纹：检查浏览器环境、Canvas指纹等
- 动态签名生成：可能基于多种因素动态生成签名
我们通过使用Playwright完全模拟浏览器环境，成功绕过了这些防爬措施。Playwright提供了真实的浏览器环境，包括JavaScript执行、Cookie管理和请求拦截等功能，使我们能够像真实用户一样与网站交互。
注意事项
- 本工具仅用于学习和研究目的
- 请遵守相关平台的使用条款和版权规定
- 不要过于频繁地使用，以避免对目标网站造成压力
安装和执行
通过Smithery安装
要通过Smithery为Claude Desktop自动安装MCP Video Download URL Parser：
npx -y @smithery/cli install @tansunyj/mcp_video_download_url_parser --client claude
手动安装
- 克隆仓库：
git clone https://github.com/tansunyj/mcp_video_download_url_parser.git - 进入目录：
cd mcp_video_download_url_parser - 安装依赖：
pip install -r requirements.txt - 启动MCP服务器：
python main.py
配置Claude Desktop或Cursor
- 添加以下配置：
{
"mcpServers": {
"video-url-parser": {
"command": "python",
"args": [
"/path/to/mcp_video_download_url_parser/main.py"
],
"env": {}
}
}
}
在魔塔社区(Cursor)部署配置
要在魔塔社区上部署此MCP服务，请按照以下步骤操作：
-
上传项目：将项目上传到魔塔社区平台
-
配置服务：在魔塔社区控制台中，找到"MCP服务配置"部分，添加以下配置信息：
{
"name": "video-url-parser",
"description": "视频下载解析工具",
"version": "1.0.0",
"main": "main.py",
"requirements": ["playwright", "asyncio", "aiohttp", "beautifulsoup4"],
"environmentVariables": {
"DOWNLOAD_PATH": "./downloads"
}
}
-
开启服务：在魔塔社区控制台中，找到已添加的服务，点击"开启服务"按钮
-
服务调用：在魔塔社区中，可以通过以下方式调用该服务：
# 调用示例
result = await mcp_video_url_parser_download_video(
url="https://v.douyin.com/your_video_id/",
output_path="指定保存路径"
)
- 常见问题排查：
- 确保所有依赖项都已正确安装
- 检查环境变量是否正确配置
- 若出现网络问题，请确认服务器能够访问视频平台网站
- 若服务无法启动，检查日志获取详细错误信息
使用示例
配置完成后，可以使用如下提示：
- "下载这个视频：[video_url]"
- "将这个视频保存到D:/videos目录：[video_url]"
环境变量
DOWNLOAD_PATH：保存下载视频的路径（默认：./downloads）
开发
要参与开发：
git clone https://github.com/tansunyj/mcp_video_download_url_parser.git
cd mcp_video_download_url_parser
python -m pytest tests/
安全性
此MCP服务器在您的本地机器上运行。虽然它不执行任意代码，但在解析来自不受信任来源的URL时请小心。
致谢
本项目使用SnapAny.com的API进行视频解析和下载。
许可证
MIT许可证
