Bilibili 收藏视频下载工具

功能概述

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

使用场景

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

前置要求

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

Script Directory

Determine this SKILL.md directory as {baseDir}.

使用方法

基本用法

用户只需要提供用户个人收藏夹 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 格式

• 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 格式，文件名格式为：

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

注意事项

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

故障排除

无法获取视频列表

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

下载速度慢

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

视频下载失败

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