🚀 媒体解析去水印(media-parser)

基于 Python 的高性能多平台视频解析与自动化管理系统（Starter 极简版）

在线体验 • 解析逻辑 • 部署指南 • 联系作者

媒体解析去水印是一款专为短视频创作者打造的自动化解析工具。

通过“智能识别 -> 绕过水印 -> 提取地址 -> 快捷下载”的闭环，助你高效获取无水印素材。

---

📱 立即体验

为了方便快速了解系统功能，我们提供了全套解决方案：

• 🌐 项目门户: https://parse.ucmao.cn/
• 🧩 小程序端: 扫描下方太阳码进行体验

协作提示：本仓库提供核心解析逻辑与 RESTful API。如需构建完整应用，请配合前端仓库使用： https://github.com/ucmao/media-parser-mp

---

💎 核心解析逻辑

• 多平台智能适配：内置 DownloaderFactory 工厂模式，自动识别链接来源并分配对应解析器。
• 深度无水印提取：封装 WebFetcher 高效抓取逻辑，精准绕过平台限制获取视频真实地址。
• 纯粹解析 API：极简版只保留了最核心的 JSON 解析服务，无数据库依赖，无鉴权门槛，非常适合开发者快速提取原型直接使用！

---

💾 支持的平台矩阵

平台名称	作者	标题	封面	视频	图集	平台名称	作者	标题	封面	视频	图集
抖音	✅	✅	✅	✅	✅	小红书	✅	✅	✅	✅	✅
快手	✅	✅	✅	✅	❌	哔哩哔哩	✅	✅	✅	✅	❌
皮皮搞笑	✅	✅	✅	✅	❌	好看视频	✅	✅	✅	✅	❌
微视	✅	✅	✅	✅	❌	梨视频	✅	✅	✅	✅	❌

---

🚀 快速开始

1. 获取源码

git clone https://github.com/ucmao/media-parser.git
cd media-parser

2. Docker 部署 (推荐)

项目自带完整的 Dockerfile 和 docker-compose 配置文件。如果你已经安装了 Docker，一键即可拉起服务：

# 构建并后台启动容器
docker-compose up -d --build

# 查看运行日志
docker-compose logs -f

容器默认运行在 8051 端口。启动成功后，你可以直接在浏览器中打开: http://localhost:8051

3. 本地环境部署 (不使用 Docker)

3.1 环境要求

• Python: 3.8 及以上版本

3.2 安装依赖

pip install -r requirements.txt

3.3 启动应用

开发模式：

python app.py

生产模式 (Gunicorn)：

gunicorn -w 4 -b 0.0.0.0:8051 app:app

📂 项目结构

media-parser/
├── app.py                # 程序入口
├── configs/              # 核心配置与业务常量
├── src/
│   ├── api/             # 路由层：API 接口处理仅保留核心 parse.py
│   ├── downloaders/     # 核心：各平台视频解析实现
│   └── downloader_factory.py # 工厂模式实现
├── static/              # 静态资源保存位置
├── utils/               # 通用工具函数 (网络请求等)
└── tests/               # 自动化测试用例

---

🔌 API 核心接口说明

解析接口：POST /api/parse

请求参数 (Request Body)

格式: application/json

参数名	类型	必填	描述	示例值
text	string	是	视频分享链接或包含链接的文本短语	"https://v.douyin.com/..."

返回说明 (Response)

格式: application/json

成功响应示例：

{
  "code": 200,
  "msg": "成功",
  "data": {
    "video_id": "7123...",
    "platform": "抖音",
    "title": "视频标题内容",
    "video_url": "https://... (无水印视频真实地址)",
    "cover_url": "https://... (高清封面地址)",
    "author": {
      "nickname": "作者昵称",
      "author_id": "作者ID",
      "avatar": "https://..."
    },
    "image_list": [
      "https://... (图文/图集地址1)",
      "https://... (图集地址2)"
    ]
  },
  "succ": true
}

失败响应示例：

{
  "code": 400,
  "msg": "该链接尚未支持提取 / 解析失败",
  "data": null,
  "succ": false
}

---

📩 联系作者

如果您在安装、使用过程中遇到问题，或有定制需求，请通过以下方式联系：

• 微信 (WeChat)：csdnxr
• QQ：294323976
• 邮箱 (Email)：leoucmao@gmail.com
• Bug反馈：GitHub Issues

---

⚖️ 开源协议 & 免责声明

1. 本项目基于 MIT LICENSE 协议开源。
2. 免责声明：本项目仅用于学习交流和技术研究。严禁用于任何非法目的。因滥用本项目造成的后果，由使用者自行承担。

优创猫去水印 - 高效解析，赋能创作。

---