其他语言版本

May 31, 2026 · View on GitHub

支持平台
安装
Docker
依赖模块

Python短视频去水印, 视频目前支持25个平台, 图集目前支持5个平台, 欢迎各位Star。

💡tips

出现解析失败可在 issue 中提问，请提供可用于复现的平台信息、分享链接.

使用时, 请尽量使用app分享链接, 电脑网页版未做充分测试.

其他语言版本

Golang版本

MCP 支持

本项目现已支持 MCP (Model Context Protocol)，提供StreamableHttp方式接入，接入URL： http://localhost:8000/mcp

支持平台

图集

平台	状态
抖音	✔
快手	✔
小红书	✔
皮皮虾	✔
微博	✔

图集 LivePhoto

平台	状态
小红书	✔
抖音	✔

视频

平台	状态
小红书	✔
皮皮虾	✔
抖音短视频	✔
火山短视频	✔
皮皮搞笑	✔
快手短视频	✔
微视短视频	✔
西瓜视频	✔
最右	✔
梨视频	✔
度小视(原全民)	✔
逗拍	✔
微博	✔
绿洲	✔
全民K歌	✔
6间房	✔
美拍	✔
新片场	✔
好看视频	✔
虎牙	✔
AcFun	✔
央视网	✔
搜狐视频	✔
哔哩哔哩	✔
腾讯视频	✔
Twitter/X	✔

运行

本地运行

使用 uv（推荐）

# 进入项目根目录
cd parse-video-py

# 创建虚拟环境并安装全部依赖
uv venv && uv pip install -e ".[all]"

# 激活虚拟环境
source .venv/bin/activate

CLI 命令行

# 安装
uv pip install -e ".[all]"

# 解析视频
parse-video-py parse "https://v.douyin.com/xxx"
parse-video-py parse "https://v.douyin.com/xxx" --format json

# 启动 Web 服务
parse-video-py serve --port 8000

# 查看版本
parse-video-py version

如需开启basic auth认证，请自行设置环境变量，不设置不开启，默认不开启

export PARSE_VIDEO_USERNAME=username
export PARSE_VIDEO_PASSWORD=password

运行app

uvicorn parse_video_py.web:app --reload

Docker运行

获取 docker image

docker pull wujunwei928/parse-video-py

运行 docker 容器, 端口 8000

docker run -d -p 8000:8000 wujunwei928/parse-video-py

运行docker容器，开启basic auth认证

docker run -d -p 8000:8000 -e PARSE_VIDEO_USERNAME=username -e PARSE_VIDEO_PASSWORD=password wujunwei928/parse-video-py

查看前端页面

访问: http://127.0.0.1:8000/

请求接口, 查看json返回

curl 'http://127.0.0.1:8000/video/share/url/parse?url=视频分享链接' | jq

返回格式

{
  "author": {
    "uid": "uid",
    "name": "name",
    "avatar": "https://xxx"
  },
  "title": "记录美好生活#峡谷天花板",
  "video_url": "https://xxx",
  "music_url": "https://yyy",
  "cover_url": "https://zzz"
}

字段名	说明
author.uid	视频作者id
author.name	视频作者名称
author.avatar	视频作者头像
title	视频标题
video_url	视频无水印链接
music_url	视频音乐链接
cover_url	视频封面
images	图集图片列表
images.[index].url	图集图片地址
images.[index].live_photo_url	图集图片 livephoto 视频地址

字段除了视频地址, 其他字段可能为空

自己写方法调用

import json
import asyncio

from parse_video_py import parse_video_share_url, parse_video_id, VideoSource

# 根据分享链接解析
video_info = asyncio.run(parse_video_share_url("分享链接"))
print(
    "解析分享链接：\n",
    json.dumps(video_info, ensure_ascii=False, indent=4, default=lambda x: x.__dict__),
    "\n",
)

# 根据视频id解析
video_info = asyncio.run(
    parse_video_id(VideoSource.DouYin, "视频ID")
)
print(
    "解析视频ID：\n",
    json.dumps(video_info, ensure_ascii=False, indent=4, default=lambda x: x.__dict__),
    "\n",
)

依赖模块

模块	作用
fastapi	web框架
fastapi-mcp	支持MCP
httpx	HTTP 和 REST 客户端
parsel	解析html页面
pre-commit	对git代码提交前进行检查，结合flake8，isort，black使用
flake8	工程化：代码风格一致性
isort	工程化：格式化导入package
black	工程化：代码格式化