Skip to main content
Glama
xhpxhpxhp

MCP Video Download URL Parser

by xhpxhpxhp
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

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：

  1. Playwright模拟浏览器（主要方法）：

    • 完全模拟真实浏览器环境

    • 自动访问snapany.com网站

    • 输入视频链接并点击提取按钮

    • 监听API响应或直接从页面提取视频元素

    • 绕过网站的防爬措施，如请求头验证、Cookie验证等

  2. API直接请求（备用方法）：

    • 直接向snapany.com的API发送请求

    • 添加必要的请求头和参数

    • 处理多种可能的响应格式

防爬措施解决方案

snapany.com网站有严格的防爬措施，包括：

  1. 请求头验证：需要特定的请求头，如g-timestamp和g-footer

  2. Cookie验证：需要有效的会话Cookie

  3. 浏览器指纹：检查浏览器环境、Canvas指纹等

  4. 动态签名生成：可能基于多种因素动态生成签名

我们通过使用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

手动安装

  1. 克隆仓库：git clone https://github.com/tansunyj/mcp_video_download_url_parser.git

  2. 进入目录：cd mcp_video_download_url_parser

  3. 安装依赖：pip install -r requirements.txt

  4. 启动MCP服务器：python main.py

配置Claude Desktop或Cursor

  1. 添加以下配置：

{ "mcpServers": { "video-url-parser": { "command": "python", "args": [ "/path/to/mcp_video_download_url_parser/main.py" ], "env": {} } } }

在魔塔社区(Cursor)部署配置

要在魔塔社区上部署此MCP服务，请按照以下步骤操作：

  1. 上传项目：将项目上传到魔塔社区平台

  2. 配置服务：在魔塔社区控制台中，找到"MCP服务配置"部分，添加以下配置信息：

{ "name": "video-url-parser", "description": "视频下载解析工具", "version": "1.0.0", "main": "main.py", "requirements": ["playwright", "asyncio", "aiohttp", "beautifulsoup4"], "environmentVariables": { "DOWNLOAD_PATH": "./downloads" } }

  1. 开启服务：在魔塔社区控制台中，找到已添加的服务，点击"开启服务"按钮

  2. 服务调用：在魔塔社区中，可以通过以下方式调用该服务：

# 调用示例 result = await mcp_video_url_parser_download_video( url="https://v.douyin.com/your_video_id/", output_path="指定保存路径" )

  1. 常见问题排查：

    • 确保所有依赖项都已正确安装

    • 检查环境变量是否正确配置

    • 若出现网络问题，请确认服务器能够访问视频平台网站

    • 若服务无法启动，检查日志获取详细错误信息

使用示例

配置完成后，可以使用如下提示：

  • "下载这个视频：[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许可证

GitHub repo

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/xhpxhpxhp/mcp_video_download_url_parser'

If you have feedback or need assistance with the MCP directory API, please join our Discord server