Bilibili 收藏视频下载工具

功能概述

此 Skill 用于下载 Bilibili 用户个人的收藏夹视频，支持批量下载、大小过滤、最高清晰度等功能。

使用场景

备份收藏夹 - 将收藏的 Bilibili 视频下载到本地
离线观看 - 下载视频以便离线观看
整理收藏 - 获取收藏视频列表并导出

前置要求

Python 3.7+
yt-dlp (会自动检查并提示安装)
网络连接

Script Directory

Determine this SKILL.md directory as {baseDir}.

| Script | Purpose | | ----------------------------- | ------------------------------ | | scripts/download_favorites.py | Main python script entry point |

使用方法

基本用法

用户只需要提供用户个人收藏夹 URL 或收藏夹 ID，工具会自动完成其余工作：请提示用户在网页上登陆 www.bilibili.com, 进入用户个人收藏夹，把浏览器地址栏收藏夹URL复制告诉AI

  Bilibili 收藏夹URL示例：https://space.bilibili.com/123456/favlist?fid=7890123

Run Script Examples with Params

基础使用（下载收藏夹，默认500MB大小限制，推荐首次使用）

python {baseDir}/scripts/download_favorites.py \
  --url "https://space.bilibili.com/123456/favlist?fid=7890123"

日常使用（推荐配置，限制300MB大小，指定输出目录）

python {baseDir}/scripts/download_favorites.py \
  --url "https://space.bilibili.com/123456/favlist?fid=7890123" \
  --size-limit 300 \
  --output-dir ~/Downloads/bilibili_favorites/

仅获取视频列表（不下载视频）

python {baseDir}/scripts/download_favorites.py \
  --url "https://space.bilibili.com/123456/favlist?fid=7890123" \
  --list-only

限制下载数量（只下载前10个视频）

python {baseDir}/scripts/download_favorites.py \
  --url "https://space.bilibili.com/123456/favlist?fid=7890123" \
  --max-download 10

参数说明

| 参数 | 说明 | 默认值 | | ------------------- | ------------------------------ | ------------------------------------------ | | --url | Bilibili 收藏夹页面 URL | 必需参数 | | --size-limit | 视频大小限制（MB），超过则跳过 | 500 | | --output-dir | 自定义下载输出目录 | ~/Downloads/bilibili_favorites/ | | --list-only | 仅获取视频列表，不下载视频 | False | | --max-download | 最大下载视频数量 | 无限制（下载全部） | | --skip-existing | 跳过已存在的视频文件（脚本默认行为）| True（无需指定） |

支持的 URL 格式

https://space.bilibili.com/{user_id}/favlist?fid={fav_id}

工作流程

解析收藏夹信息 - 从 URL 中提取用户 ID 和收藏夹 ID
获取视频列表 - 调用 Bilibili API 获取所有收藏视频（支持分页）
估算视频大小 - 使用 yt-dlp 获取视频信息并估算大小
过滤视频 - 根据大小限制过滤视频
批量下载 - 使用 yt-dlp 下载视频，自动合并音视频
生成报告 - 输出下载统计信息

输出说明

下载的视频将保存为 MP4 格式，文件名格式为：

{视频标题}_{BV号}.mp4

注意事项

下载的视频仅供个人学习使用
请遵守 Bilibili 用户协议和相关法律法规
部分高清晰度视频需要大会员才能下载
失效视频会自动跳过并记录

故障排除

无法获取视频列表

检查收藏夹是否为公开状态
检查网络连接
确认收藏夹 ID 正确

下载速度慢

这是正常现象，取决于视频大小和网络状况
工具支持断点续传，可以随时中断并继续

视频下载失败

可能是视频已失效或被删除
可能是网络问题，可以重新运行脚本