bilibili-video-downloader

# Bilibili Video Downloader 基于 [yt-dlp](https://github.com/yt-dlp/yt-dlp) 封装的哔哩哔哩视频下载工具。 ## 快速参考 | 脚本 | 用途 | |------|------| | `install-check.ps1` | 检查依赖是否安装 (Windows) | | `install-check.sh` | 检查依赖是否安装 (macOS/Linux) | | `search.ps1/sh <关键词> [数量]` | 搜索B站视频 | | `download.ps1/sh <URL> [清晰度]` | 下载单个视频 | | `video-info.ps1/sh <URL>` | 获取视频详情 | ## 快速开始 ### Windows ```powershell 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 ```bash cd scripts/ # 1. 检查依赖 ./install-check.sh # 2. 搜索视频 ./search.sh "Python教程" 10 # 3. 下载视频 ./download.sh "https://www.bilibili.com/video/BV1xx411c7mD" ``` ## 搜索视频 ### Windows ```powershell .\search.ps1 -Keyword "关键词" -Limit 20 # 示例 .\search.ps1 -Keyword "深度学习" -Limit 20 .\search.ps1 -Keyword "考研数学" -Limit 10 ``` ### macOS / Linux ```bash ./search.sh "关键词" [结果数量] # 示例 ./search.sh "深度学习" 20 ./search.sh "考研数学" 10 ``` 输出格式： ``` 标题 | UP主 | 播放量 | BV号 | 链接 ``` ## 下载视频 ### 单视频下载 **Windows:** ```powershell .\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:** ```bash ./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）： ```bash ./download-batch.sh urls.txt 1080 ./downloads ``` ## 获取视频信息 **Windows:** ```powershell .\video-info.ps1 -Url "https://www.bilibili.com/video/BV1xx411c7mD" ``` **macOS / Linux:** ```bash ./video-info.sh "https://www.bilibili.com/video/BV1xx411c7mD" ``` ## 获取UP主视频列表 (macOS/Linux) ```bash # 获取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) ```bash ./comments.sh "https://www.bilibili.com/video/BV1xx411c7mD" 100 ``` ## 下载弹幕 (macOS/Linux) ```bash ./danmaku.sh "https://www.bilibili.com/video/BV1xx411c7mD" danmaku.xml ``` ## 依赖要求 - Python 3.8+ - yt-dlp - ffmpeg (用于合并音视频) ## 安装依赖 ### Windows ```powershell # 安装 Python winget install Python.Python.3.12 # 安装 yt-dlp pip install yt-dlp # 安装 ffmpeg winget install Gyan.FFmpeg ``` ### macOS ```bash # 安装 Python 和 yt-dlp brew install python yt-dlp ffmpeg # 或 pip3 install yt-dlp ``` ### Ubuntu / Debian ```bash 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 的执行环境有安全限制，可能无法直接写入文件。 | 功能 | 状态 | 说明 | |------|------|------| | 获取视频信息 | ✅ 可用 | 可以获取标题、播放量、清晰度等 | | 生成下载命令 | ✅ 可用 | 可以生成 yt-dlp 命令 | | 自动下载文件 | ⚠️ 受限 | 取决于执行环境权限 | ### 解决方案 **方案 A：手动执行（推荐）** AI 提供下载命令，你自己复制粘贴运行： ```powershell yt-dlp "https://www.bilibili.com/video/BV18NzvB5EZu" -o "$HOME\Downloads\%(title)s.%(ext)s" ``` **方案 B：提升权限（可选）** 如需 AI 直接下载文件，请参考 [PERMISSIONS.md](PERMISSIONS.md) 配置权限。 ## 工作原理 本Skill基于 [yt-dlp](https://github.com/yt-dlp/yt-dlp) 实现： - 视频搜索：使用 yt-dlp 的搜索功能 - 视频下载：自动选择最佳音视频流并合并 - 信息获取：解析B站API返回的元数据 - 弹幕/评论：调用B站公开API获取