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

Appeared in Searches

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