bilibili-audio

name	bilibili-audio
description	下载B站视频音频。支持单个视频下载和批量下载UP主所有视频。当用户提供B站视频链接（bilibili.com、b23.tv）、要求下载B站音频、下载B站视频、提取B站音频、或批量下载某个UP主的视频时使用。触发词：B站下载、bilibili下载、下载B站音频、B站音频、哔站下载。
user-invocable	true

B站音频下载

下载B站视频音频，支持单个视频和批量UP主下载。

输入识别

根据用户输入自动判断模式：

输入类型	示例	模式
视频URL	https://www.bilibili.com/video/BVxxx	单个下载
短链接	https://b23.tv/xxx	单个下载
用户ID	593926706	批量下载
UP主链接	https://space.bilibili.com/593926706	批量下载

单个视频下载

当用户提供视频链接时：

mkdir -p ~/B站音频下载

BBDown --audio-only \
  --work-dir ~/B站音频下载 \
  -F '<publishDate>_<videoTitle>_<bvid>' "<视频URL>"

open ~/B站音频下载/

报告下载结果：标题、时长、文件大小、保存路径。

批量UP主下载

当用户提供用户ID或UP主空间链接时：

1. 提取用户ID

从 https://space.bilibili.com/593926706 提取 593926706。

2. 获取视频列表（推荐方法：使用 BBDown）

使用 BBDown 的 debug 模式获取视频列表，无需硬爬 API：

SCRIPT_DIR="$(dirname "$0")"
python3 ~/.claude/skills/bilibili-audio/scripts/bbdown_space_crawler.py <用户ID> ~/bilibili_<用户ID>_videos.csv

原理说明：

• BBDown 在解析 UP主空间投稿页面时会获取完整的视频列表
• 通过 --debug 参数可以输出原始 JSON 数据
• 脚本从 debug 输出中提取 bvid 和标题信息
• 此方法使用 BBDown 的内置能力，更加稳定可靠
• 支持获取隐藏空间的视频列表（即使 UP主设置了隐私保护）
• 使用 /upload/video 页面绕过部分 412 限制

3. 提取视频URL

tail -n +2 ~/bilibili_<用户ID>_videos.csv | cut -d',' -f3 > ~/bilibili_<用户ID>_videos.txt

4. 创建下载目录

mkdir -p ~/B站音频下载/<用户ID>

5. 批量下载（随机间隔防封禁）

while read url; do
  echo "=== 下载: $url ==="
  BBDown --audio-only --save-archives-to-file \
    --work-dir ~/B站音频下载/<用户ID> \
    -F '<publishDate>_<videoTitle>_<bvid>' "$url"
  delay=$((RANDOM % 6 + 3))
  echo "等待 $delay 秒..."
  sleep $delay
done < ~/bilibili_<用户ID>_videos.txt

6. 完成

open ~/B站音频下载/<用户ID>/

报告下载数量和失败情况。

功能特性

• 最高音质（自动选择最高码率）
• 自动跳过已下载视频
• 字幕自动嵌入（如可用）
• 文件命名：日期_标题_BV号.m4a
• 随机间隔（3-8秒）防封禁，模拟人类行为
• 使用 BBDown 内置能力获取视频列表，稳定可靠

故障排查

问题	解决方案
未安装 BBDown	brew install BBDown
Cookie 过期	重新登录B站更新 cookie
视频不可用	可能被删除或会员专享
重新下载已跳过的	rm -f ~/tools/BBDown.archives
获取视频列表失败	检查 BBDown 是否已登录