Bilibili Video Downloader

基于 yt-dlp 封装的哔哩哔哩视频下载工具。

快速参考

快速开始

Windows

cd scripts\

# 1. 检查依赖
.\install-check.ps1

# 2. 搜索视频
.\search.ps1 -Keyword "Python教程" -Limit 10

# 3. 下载视频（默认最高清晰度）
.\download.ps1 -Url "https://www.bilibili.com/video/BV1xx411c7mD"

# 4. 指定清晰度下载
.\download.ps1 -Url "https://www.bilibili.com/video/BV1xx411c7mD" -Quality 1080

macOS / Linux

cd scripts/

# 1. 检查依赖
./install-check.sh

# 2. 搜索视频
./search.sh "Python教程" 10

# 3. 下载视频
./download.sh "https://www.bilibili.com/video/BV1xx411c7mD"

搜索视频

Windows

.\search.ps1 -Keyword "关键词" -Limit 20

# 示例
.\search.ps1 -Keyword "深度学习" -Limit 20
.\search.ps1 -Keyword "考研数学" -Limit 10

macOS / Linux

./search.sh "关键词" [结果数量]

# 示例
./search.sh "深度学习" 20
./search.sh "考研数学" 10

输出格式：

标题 | UP主 | 播放量 | BV号 | 链接

下载视频

单视频下载

Windows:

.\download.ps1 -Url "<URL>" -Quality <清晰度> -OutputDir <目录>

# 清晰度选项: 360, 480, 720, 1080, 1080p+, 4K (默认best)

.\download.ps1 -Url "https://www.bilibili.com/video/BV1xx411c7mD"
.\download.ps1 -Url "https://www.bilibili.com/video/BV1xx411c7mD" -Quality 1080 -OutputDir ".\my-videos"

macOS / Linux:

./download.sh <URL> [清晰度] [输出目录]

./download.sh "https://www.bilibili.com/video/BV1xx411c7mD"
./download.sh "https://www.bilibili.com/video/BV1xx411c7mD" 1080 ./downloads

批量下载

创建包含URL的文件（每行一个）：

https://www.bilibili.com/video/BV1xx411c7mD
https://www.bilibili.com/video/BV1yy411c7nE
https://www.bilibili.com/video/BV1zz411c7oF

然后执行（macOS/Linux）：

./download-batch.sh urls.txt 1080 ./downloads

获取视频信息

Windows:

.\video-info.ps1 -Url "https://www.bilibili.com/video/BV1xx411c7mD"

macOS / Linux:

./video-info.sh "https://www.bilibili.com/video/BV1xx411c7mD"

获取UP主视频列表 (macOS/Linux)

# 获取UP主视频列表
./up-videos.sh "UID" 50

# 示例：获取UID为208259的UP主前30个视频
./up-videos.sh 208259 30

如何获取UID：打开UP主主页，URL中的数字就是UID，如 space.bilibili.com/208259

获取评论 (macOS/Linux)

./comments.sh "https://www.bilibili.com/video/BV1xx411c7mD" 100

下载弹幕 (macOS/Linux)

./danmaku.sh "https://www.bilibili.com/video/BV1xx411c7mD" danmaku.xml

依赖要求

• Python 3.8+
• yt-dlp
• ffmpeg (用于合并音视频)

安装依赖

Windows

# 安装 Python
winget install Python.Python.3.12

# 安装 yt-dlp
pip install yt-dlp

# 安装 ffmpeg
winget install Gyan.FFmpeg

macOS

# 安装 Python 和 yt-dlp
brew install python yt-dlp ffmpeg

# 或
pip3 install yt-dlp

Ubuntu / Debian

sudo apt update
sudo apt install python3 python3-pip ffmpeg
pip3 install yt-dlp

注意事项

• 下载的视频仅供个人学习使用，请遵守版权法规
• 部分视频需要登录才能下载高清版本
• 大会员专享视频需要配置cookies
• 建议配置cookies以获得最佳下载体验

配置Cookies（可选）

如需下载大会员专享或高清视频，配置cookies：

1. 浏览器登录B站
2. 使用浏览器扩展导出cookies为txt格式（如 "Get cookies.txt"）
3. 保存为 cookies.txt 放在脚本目录

执行环境权限说明

⚠️ 重要提示：本 Skill 的执行环境有安全限制，可能无法直接写入文件。

解决方案

方案 A：手动执行（推荐） AI 提供下载命令，你自己复制粘贴运行：

yt-dlp "https://www.bilibili.com/video/BV18NzvB5EZu" -o "$HOME\Downloads\%(title)s.%(ext)s"

方案 B：提升权限（可选） 如需 AI 直接下载文件，请参考 PERMISSIONS.md 配置权限。

工作原理

本Skill基于 yt-dlp 实现：

• 视频搜索：使用 yt-dlp 的搜索功能
• 视频下载：自动选择最佳音视频流并合并
• 信息获取：解析B站API返回的元数据
• 弹幕/评论：调用B站公开API获取