2026-08-29 17:01:55 +08:00

Media-Parser Logo

基于 Python 的多平台媒体原生本地解析系统

License Python Version Flask Docker Support

解析逻辑 • 支持平台 • 部署指南 • 接口文档 • 测试自检 • 开发文档 • 联系作者

媒体解析去水印是一款专为短视频创作者与开发者打造的原生本地解析工具。

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

100%本地原生实现,不依赖外部API,不封装第三方解析库,核心逆向逻辑完全开源。


💎 核心解析逻辑

  • 多平台智能适配:内置 ParserFactory 工厂模式,自动识别链接来源并分配对应解析器。
  • 原生本地解析:解析逻辑直接内置在项目代码中,由各平台 Parser 本地发起请求并提取真实媒体地址。
  • 零外部API依赖:无需对接任何第三方代解析接口或 SaaS 中转服务,部署后即可独立稳定运行。
  • 开箱即用API:提供标准化的 JSON 数据接口,无冗余数据库依赖,适合快速对接业务或二次开发。

✨ 项目特点

  • 本地可控:所有请求链路与解析规则均在本地代码中,方便调试、维护与定制。
  • 部署简单:安装依赖或使用 Docker 即可一键运行,不需要额外申请第三方 API 账号或密钥。
  • 便于扩展:各平台对应独立 Parser,遵循统一的返回数据结构,新增平台轻松快捷。

💾 支持的平台矩阵

平台名称 作者 标题 封面 视频 图集 音频 字幕 平台名称 作者 标题 封面 视频 图集 音频 字幕
抖音 ✓ ✓ ✓ ✓ ✓+ ✓ ✓ 剪映 / CapCut ✓ ✓ ✓ ✓ ✓ ✓
小红书 ✓ ✓ ✓ ✓ ✓+ 快影 ✓ ✓ ✓ ✓ ✓
视频号 ✓ ✓ ✓ ✓ 皮皮搞笑 ✓ ✓ ✓ ✓
微信公众号 ✓ ✓ ✓ ✓ ✓ ✓ 微视 ✓ ✓ ✓ ✓
快手 ✓ ✓ ✓ ✓ ✓+ ✓ AcFun ✓ ✓ ✓ ✓
哔哩哔哩 ✓ ✓ ✓ ✓ ✓ 西瓜视频 ✓ ✓ ✓ ✓
豆包 ✓ ✓ ✓ ✓ ✓ 今日头条 ✓ ✓ ✓ ✓
即梦AI ✓ ✓ ✓ ✓ 绿洲 ✓ ✓ ✓ ✓ ✓
小云雀AI ✓ ✓ ✓ ✓ ✓ 皮皮虾 ✓ ✓ ✓ ✓
可灵AI ✓ ✓ ✓ ✓ 全民K歌 ✓ ✓ ✓
海螺AI ✓ ✓ ✓ ✓ ✓ 新片场 ✓ ✓ ✓ ✓
夸克AI ✓ ✓ ✓ ✓ ✓ 好看视频 ✓ ✓ ✓ ✓
通义千问 ✓ ✓ ✓ ✓ ✓ 梨视频 ✓ ✓ ✓ ✓
腾讯元宝 ✓ ✓ ✓ ✓ ✓ 微博 ✓ ✓ ✓ ✓ ✓
闲鱼 ✓ ✓ ✓ 知乎 ✓ ✓ ✓ ✓ ✓
拼多多 ✓ ✓ ✓ ✓ ✓ 虎牙 ✓ ✓ ✓
Soul ✓ ✓ ✓ ✓ ✓ 美拍 ✓ ✓ ✓ ✓
汽水音乐 ✓ ✓ ✓ ✓ ✓ ✓ 最右 ✓ ✓ ✓
QQ音乐 ✓ ✓ ✓ ✓ 番茄小说 ✓ ✓ ✓ ✓
网易云音乐 ✓ ✓ ✓ ✓ ✓+ ✓ ✓ 红果短剧 ✓ ✓ ✓ ✓
酷狗音乐 ✓ ✓ ✓ ✓ ✓ 红果漫剧 ✓ ✓ ✓ ✓
配音秀 ✓ ✓ ✓ ✓ 得物 ✓ ✓ ✓ ✓ ✓
松果时刻 ✓ ✓ ✓ ✓ ✓ ✓ 网易LOFTER ✓ ✓ ✓ ✓ ✓
腾讯频道 ✓ ✓ ✓ ✓

💡 说明:

  • 图集 ✓+:表示该平台支持提取 iOS/Android 原始 LivePhoto 动态实况图(含封面静图与关联 .mov/.mp4 实况视频原件)。
  • 原生水印提示:腾讯元宝等极少数平台提取的是官方存储桶原画质直链,素材保留官方原生水印。

🚀 部署指南

大多数平台无需登录态即可解析;如需按需增强部分特定功能(如豆包无水印视频、微信视频号等),请先复制环境变量示例文件:

cp .env.example .env

然后在本地 .env 中按需填写对应配置:

  1. 抖音放映厅长视频 (DOUYIN_COOKIE):
    • 仅在解析放映厅/影视长片/演唱会大片等强风控内容时才需要配置。推荐精简 Cookie 配置 s_v_web_id=xxx; __ac_nonce=xxx,该字段不是个人账号登录信息,仅为字节安全 SDK 的人机风控通行证。日常 99% 的普通短视频、图文笔记、LivePhoto、原声音乐等完全免 Cookie 匿名解析。
  2. 豆包无水印视频 (DOUBAO_COOKIE):
    • 用于解密获取 1080P 原始纯净无水印视频。由于该字段包含豆包的个人账号登录会话凭证,建议使用闲置小号。推荐精简 Cookie 配置 sessionid_ss=xxx。未配置时仍可解析公开图片与带水印预览切片。
  3. 微信视频号视频 (YUANBAO_COOKIE):
    • 通过腾讯元宝接口提取视频号原始流。由于该接口绑定了腾讯元宝的账号会话(属于个人账号登录凭证),建议使用闲置小号。推荐精简 Cookie 配置 hy_user=xxx; hy_token=xxx。未配置时仅可获取除视频外的其他信息。
  4. 拼多多视频 (PINDUODUO_COOKIE):
    • 用于多多视频原画解析。登录 mobile.yangkeduo.com(拼多多移动网页版)后获取,推荐精简 Cookie 配置 PDDAccessToken=xxx。由于该字段属于个人账号登录凭证,建议使用闲置小号。未配置时仍可免 Cookie 解析商品图与评价素材。

Docker 部署(推荐)

通过 Docker Compose 快捷构建并启动服务;如需配置 Cookie,请先按上方说明配置 .env:

# 1. 获取源码
git clone https://github.com/ucmao/media-parser.git
cd media-parser

# 2. 构建并启动服务
docker-compose up -d --build

# 3. 查看日志与运行状态
docker-compose logs -f web

服务默认监听 8051 端口,启动后直接访问 http://localhost:8051。


Python 环境运行

适用于调试、二次开发或直接在宿主机运行。推荐 Python 3.10+(兼容 Python 3.8+);如需解析豆包或视频号视频,请先按上方说明配置 .env。

# 1. 安装依赖
pip install -r requirements.txt

# 2. 启动服务
python app.py

🔌 API 核心接口说明

1. 服务健康检查

  • 接口路径:GET /api/health
  • 接口描述:供容器编排(Docker Compose/K8s)、反向代理或监控系统探针检测服务存活状态。
  • 返回示例:
    {
      "status": "ok"
    }
    

2. 媒体解析接口

  • 接口路径:POST /api/parse
  • 接口描述:传入包含分享链接的文本,智能提取多媒体直链与图文信息。

请求参数 (Request Body)

格式: application/json

参数名 类型 必填 描述 限制与示例
text string 是 视频分享链接或包含链接的文本短语 最长 2000 字符,如 "https://v.douyin.com/..."

返回说明 (Response)

格式: application/json

成功响应示例:

{
  "retcode": 200,
  "retdesc": "成功",
  "data": {
    "video_id": "7123...",
    "platform": "抖音",
    "title": "视频标题内容",
    "video_url": "https://... (主视频地址)",
    "video_list": [
      "https://... (仅多视频/合集内容额外返回,首项与 video_url 相同)"
    ],
    "audio_url": "https://... (背景音乐/独立音频地址)",
    "cover_url": "https://... (高清封面地址)",
    "author": {
      "nickname": "作者昵称",
      "author_id": "作者ID",
      "avatar": "https://..."
    },
    "image_list": [
      "https://... (普通图集地址)",
      {
        "url": "https://... (实况图封面地址)",
        "live_photo_url": "https://... (实况图视频原件地址)"
      }
    ],
    "subtitles": [
      { "start": 0.64, "end": 2.12, "text": "文案/字幕内容" }
    ]
  },
  "succ": true
}

失败响应示例:

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

🧪 自动化测试与健康自检

本项目拥有完备的双层测试体系(Mock 单元测试 + 47 平台真实在线样本库回归)。遇到解析异常或日常部署验证时,可一键运行健康自检:

# 47 平台极速冒烟测试(每个平台测 1 条最具代表性的链接,秒级完成健康检查)
python3 tests/manual_verify_parsers.py --limit 1

# 仅验证单个或指定平台(如:小云雀AI / 抖音)
python3 tests/manual_verify_parsers.py --platform "小云雀AI"

💡 更多多形态全量回归测试命令与 Pytest 自动化规范,请参阅 测试体系与回归验证指南 (docs/testing.md)。


📖 开发者文档与逆向百科

本项目提供了详尽的技术架构与全平台逆向分析手册,详细内容请查阅 docs/ 目录:


📩 联系作者

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


⚖️ 开源协议 & 免责声明

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

S
Description
Media-Parser是一个高性能RESTful API解析去水印服务,专注于多平台短视频的解析与去水印核心功能。它支持抖音、小红书、视频号、豆包、即梦等50+主流平台,支持获取作者、标题、封面、视频、图集、音频、Live实况等,并提供简洁易用的接口供前端调用。项目采用下载器工厂模式实现平台兼容性,是支撑去水印小程序或Web应用的理想后端解决方案。
Readme MIT 4.9 MiB
Languages
Python 65.2%
HTML 28.8%
JavaScript 5%
CSS 0.8%