Bilibili Video Downloader Skill — Development skill for Claude Code

B站视频下载 Skill

一个 Agent Skill：给一个 BV 号或视频链接，就能下载 B 站视频的最高 1080P MP4。

**全自动流程**：打开浏览器扫码登录 → 自动抓取 Cookie → 调用官方 API 拿 DASH 直链 → 下载音视频分离流 → ffmpeg 无损合并为 MP4。**不需要手动复制 Cookie，不需要打开 DevTools。**

---

特性

• 扫码登录，全自动取 Cookie — 弹出浏览器让你扫码，脚本轮询检测到 SESSDATA 后自动保存，全程无手动复制
• 1080P 真高清 — 带登录 Cookie 请求 qn=80，匿名状态下 B 站最高只给 720P
• DASH 流分离下载 + ffmpeg 无损合并 — -c copy，不重新编码，秒级完成，画质零损失
• H.264 优先 — 自动选 avc1 而非 hvc1（H.265），兼容性更好
• 多级自动降级 — 1080P 不可用自动退 720P、480P；主 CDN 失败自动切备用 CDN
• 合并失败自动兜底 — -c copy 失败时回退到 libx264 重编码
• 成品自校验 — 合并后用 ffprobe 校验分辨率、编码、时长
• 批量下载 — 逐集下载，自动间隔规避 B 站 -412 风控

---

适用系统

系统	下载功能	自动获取 Cookie	验证状态
Windows 10 / 11	✅	✅	实机验证通过（含中文路径、1080P 全流程）
macOS	✅	✅	代码层面无平台依赖，未实机验证
Linux（带桌面环境）	✅	✅	代码层面无平台依赖，未实机验证
Linux（无桌面的服务器）	✅	❌	代码层面无平台依赖，未实机验证

**几点必须说清楚的：**

• 上表只有 **Windows 一行是实测过的**。macOS 和 Linux 的结论来自逐行代码审查（无硬编码路径、无 `shell=True`、无盘符、无 Windows API 调用），**不是跑出来的**——我手上没有 macOS / Linux 机器可测。实际使用如遇问题欢迎开 Issue。

• **无桌面的 Linux 服务器有个硬限制**：`get_cookies.py` 要弹出可见的浏览器窗口供你扫码，纯命令行环境跑不了。这类环境下可以手动取一次 Cookie（见[方案 C](#方案-c手动获取仅在自动获取失败时)），之后 `bilibili_downloader.py` 照常可用。

• **Linux 装 Playwright 需要补系统依赖**，只跑 `playwright install chromium` 常因缺库失败。需要：

  sudo playwright install-deps chromium

---

环境要求

依赖	说明
Python	3.7+（sys.stdout.reconfigure 需要 3.7；开发环境为 3.13）
ffmpeg	必需。合并音视频流
requests	必需。HTTP 请求
playwright	可选，但强烈建议。自动获取 Cookie 用

**Windows 下命令用 `python`，macOS / Linux 下用 `python3`。** 本文档统一写 `python`，非 Windows 平台请自行替换。

安装依赖

pip install requests playwright
playwright install chromium

# 仅 Linux 需要：补齐 Chromium 的系统依赖
sudo playwright install-deps chromium

**安装 ffmpeg：**

# Windows
winget install Gyan.FFmpeg

# macOS
brew install ffmpeg

# Debian / Ubuntu
sudo apt install ffmpeg

# Fedora
sudo dnf install ffmpeg

# Arch
sudo pacman -S ffmpeg