wangduoyu001/hongguo-drama-downloader/hongguo-drama-downloader

红果短剧批量下载器

适用场景

• 用户想批量下载红果短剧整部，用于个人学习分镜 / 离线研究。
• 需要从红果网页版播放页提取 m3u8 直链并合并为 mp4。
• 关键词触发：红果短剧下载、批量下载短剧、m3u8 短剧解析、短剧下载器。

原理

红果网页版 https://www.hongguoapp.cn 是苹果CMS(conch 模板) 聚合站。每集播放页 /vodplay/{id}-1-{n}.html 内嵌若干段 JSON：

var player_aaaa={"flag":"play","encrypt":0,...,"url":"https://xxx/index.m3u8",...}
var player_bbbb={...}   # 备用播放源（不同 CDN）

• encrypt=0 未加密，url 即可直接下载的 m3u8 直链。
• 不同剧的 CDN 域名会轮换（wwzycdn.10cong.com、wangwangzyvod.com 等）。
• 脚本遍历所有 player_* 变量，取第一个合法 m3u8；逐集解析→下载→合并 mp4。

前置依赖（用户本地电脑，非云端）

1. Python 3.8+。
2. 下载后端二选一（yt-dlp 优先）：

• pip install yt-dlp
• 或下载 ffmpeg 加入 PATH。

1. 必须在家庭宽带电脑运行：红果视频 CDN(HyperCDN) 屏蔽数据中心 IP，云服务器/沙箱下分片会被 502 拦截。

用法

# 随机剧解析自测（不下载，验证解析逻辑 + CDN 域名分布）
python hongguo_downloader.py --selftest 20
 
# 先测 1 集确认能下（最关键）
python hongguo_downloader.py --id 15297 --test
 
# 整部批量下载
python hongguo_downloader.py --id 15297 --out "D:/短剧"
 
# 按剧名搜索（家庭宽带通常可过，被拦则改用 --id）
python hongguo_downloader.py --name "宴律" --out "D:/短剧"
 
# 区间 / 延时防封 / Cookie
python hongguo_downloader.py --id 15297 --start 5 --end 10
python hongguo_downloader.py --id 15297 --delay 3
python hongguo_downloader.py --id 15297 --cookie "session=xxxxx"

拿到 id：浏览器打开红果 → 点开那部剧 → 地址栏 /voddetail/15297.html 里的数字。

关键注意 / Caveat

• ⚠️ 数据中心 IP 限制：本机（云/沙箱）只能验证「解析逻辑」与「用公共测试流验证下载合并代码路径」，真实整集视频须用户家庭宽带电脑执行。脚本已对 403/502 打印明确提示。
• ⚠️ 合规：仅供个人学习分镜、离线看；请勿传播、二创搬运、商用；控制抓取频率避免被封。

故障排查

• 大量 502/403：CDN 屏蔽 IP 或需登录态 → 换家庭宽带、用浏览器登录后导出 Cookie 传 --cookie、调大 --delay、降频。
• 搜索被 Cloudflare 拦：直接用 --id 最稳。
• 断流重跑：已存在集自动跳过，单集失败自动重试 2 次。

文件

• hongguo_downloader.py：下载器主程序（含 --selftest）。
• README.md：完整使用说明。