mirror of
https://github.com/ucmao/media-parser.git
synced 2026-11-20 08:04:56 +08:00
v1.0.0
🚀 Media Parser 后端(parse-ucmao-backend)
基于 Python 的高性能多平台视频解析与自动化管理系统
Media Parser是一款专为短视频创作者打造的自动化解析工具。
通过“智能识别 -> 绕过水印 -> 提取地址 -> 快捷下载”的闭环,助你高效获取无水印素材。
📱 立即体验
为了方便快速了解系统功能,我们提供了全套解决方案:
- 🌐 项目门户: https://parse.ucmao.cn/ (扫码引导页)
- ⚙️ 管理后台: https://parse.ucmao.cn/admin/
- 演示者:
guest/guest123(仅查看权限,部分功能需部署后使用)
- 演示者:
- 🧩 小程序端: 扫描下方太阳码进行体验
协作提示:本仓库提供核心解析逻辑与 RESTful API。如需构建完整应用,请配合前端仓库使用: https://github.com/ucmao/parse-ucmao-mp
💎 核心解析逻辑
- 多平台智能适配:内置
DownloaderFactory工厂模式,自动识别链接来源并分配对应解析器。 - 深度无水印提取:封装
WebFetcher高效抓取逻辑,精准绕过平台限制获取视频真实地址。 - 用户与权限系统:集成微信登录鉴权,记录查询日志与视频访问频次,支持运营数据统计。
- 灵活分发接口:提供标准 RESTful 接口,可轻松对接小程序、Web 端或第三方自动化脚本。
💾 支持的平台矩阵
| 平台名称 | 识别状态 | 平台名称 | 识别状态 |
|---|---|---|---|
| 抖音 | ✅ 完美支持 | 小红书 | ✅ 完美支持 |
| 快手 | ✅ 完美支持 | 哔哩哔哩 | ✅ 完美支持 |
| 皮皮搞笑 | ✅ 完美支持 | 好看视频 | ✅ 完美支持 |
| 微视 | ✅ 完美支持 | 梨视频 | ✅ 完美支持 |
🔌 API 核心接口说明
解析接口:POST /api/parse
| 参数 | 描述 | 示例值 |
|---|---|---|
text |
视频分享链接/包含链接的文本 | https://v.douyin.com/... |
code |
(Login 接口) 微信登录凭证 | wx_login_code |
video_url |
(Download 接口) 视频原始地址 | http://... |
🚀 快速开始
0. 环境要求
- Python: 3.8 及以上版本
- MySQL: 5.7 或 8.0+
1. 获取源码
git clone https://github.com/ucmao/parse-ucmao-backend.git
cd parse-ucmao-backend
2. 安装依赖
pip install -r requirements.txt
3. 环境配置 (.env)
在项目根目录下创建 .env 文件(参考 .env.example):
# 核心域名
DOMAIN = your_domain_here
# 用于加密 Session
SECRET_KEY =your_secret_key
# 微信小程序登录配置
WECHAT_APP_ID = your_wechat_app_id_here
WECHAT_APP_SECRET = your_wechat_app_secret_here
# MYSQL 数据库配置
DB_HOST = localhost
DB_PORT = 3306
DB_NAME = parse_ucmao
DB_USER = root
DB_PASSWORD = your_password_here
# 服务端下载缓存配置(可选)
# 仅缓存不超过该大小的小文件,单位:MB,默认 15
MAX_CACHE_SIZE_MB = 15
# 后台管理员账号 (可选)
ADMIN_USER = admin
ADMIN_PASSWORD = admin123
# 后台游客账号 (可选)
DEMO_USER = guest
DEMO_PASSWORD = guest123
4. 初始化数据库
# 导入表结构(脚本会自动创建数据库 parse_ucmao)
mysql -u root -p < schema.sql
5. 启动应用
开发模式:
python app.py
生产模式 (Gunicorn):
gunicorn -w 4 -b 0.0.0.0:5001 app:app
📂 项目结构
parse-ucmao-backend/
├── app.py # 程序入口
├── configs/ # 核心配置与业务常量
├── src/
│ ├── api/ # 路由层:API 接口处理
│ ├── database/ # 数据层:MySQL CRUD 封装
│ ├── downloaders/ # 核心:各平台视频解析实现
│ └── downloader_factory.py # 工厂模式实现
├── static/ # 静态资源
├── utils/ # 通用工具函数 (网络请求等)
├── schema.sql # 数据库初始化脚本
└── tests/ # 自动化测试用例
📩 联系作者
如果您在安装、使用过程中遇到问题,或有定制需求,请通过以下方式联系:
- 微信 (WeChat):csdnxr
- QQ:294323976
- 邮箱 (Email):leoucmao@gmail.com
- Bug反馈:GitHub Issues
⚖️ 开源协议 & 免责声明
- 本项目基于 MIT LICENSE 协议开源。
- 免责声明:本项目仅用于学习交流和技术研究。严禁用于任何非法目的。因滥用本项目造成的后果,由使用者自行承担。
Media Parser - 高效解析,赋能创作。
Description
Media-Parser是一个高性能RESTful API解析去水印服务,专注于多平台短视频的解析与去水印核心功能。它支持抖音、小红书、视频号、豆包、即梦等50+主流平台,支持获取作者、标题、封面、视频、图集、音频、Live实况等,并提供简洁易用的接口供前端调用。项目采用下载器工厂模式实现平台兼容性,是支撑去水印小程序或Web应用的理想后端解决方案。
doubaodouyindouyin-downloadermedia-parserno-watermarkvideo-downloaderxiaohongshuxiaohongshu-downloader
Readme
MIT
4.9 MiB
Languages
Python
65.2%
HTML
28.8%
JavaScript
5%
CSS
0.8%

