Bilibili 收藏视频下载工具#

功能概述#

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

使用场景#

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

前置要求#

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

Script Directory#

Determine this SKILL.md directory as {baseDir}.

ScriptPurpose{baseDir}/scripts/download_favorites.pyMain python script entry point

使用方法#

基本用法#

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

text

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

Run Script Examples with Params#

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

bash

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

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

bash

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

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

bash

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

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

bash

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

参数说明#

参数说明默认值--urlBilibili 收藏夹页面 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}

工作流程#

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

输出说明#

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

text

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

注意事项#

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

故障排除#

无法获取视频列表#

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

下载速度慢#

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

视频下载失败#

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