- name
- bilibili-favorites-downloader
- description
- |
Bilibili 收藏视频下载工具
功能概述
此 Skill 用于下载 Bilibili 用户个人的收藏夹视频，支持批量下载、大小过滤、最高清晰度等功能。
使用场景
- 备份收藏夹 - 将收藏的 Bilibili 视频下载到本地
- 离线观看 - 下载视频以便离线观看
- 整理收藏 - 获取收藏视频列表并导出
前置要求
- Python 3.7+
- yt-dlp (会自动检查并提示安装)
- 网络连接
Script Directory
Determine this SKILL.md directory as {baseDir}.
| Script | Purpose |
|---|---|
{baseDir}/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=7890123Run 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 正确
下载速度慢
- 这是正常现象，取决于视频大小和网络状况
- 工具支持断点续传，可以随时中断并继续
视频下载失败
- 可能是视频已失效或被删除
- 可能是网络问题，可以重新运行脚本