bilibili-cli — bilibili-命令行工具

bilibili-cli 技能 一个用于与 Bilibili (哔哩哔哩) 交互的 CLI 工具。使用它来获取视频信息、搜索内容、浏览用户资料，并执行喜欢或三连等交互操作。

代理默认值 当您需要机器可读输出时： 首先更喜欢 --yaml，因为它通常比 pretty JSON 更节省令牌。 仅当下游工具严格要求 JSON 时使用 --json。 使用 --max、--page 或 --offset 保持结果集小。 更喜欢特定的命令而不是广泛的命令。 示例：使用 bili user-videos 946974 --max 3 --yaml 代替获取大型时间线。 在总结视频时，先获取字幕。字幕通常包含视频的核心内容，是总结的最佳主要来源。 仅当字幕不可用或明显不足时，才回退到 --ai、评论或音频提取。

先决条件 # 安装（需要 Python 3.10+） uv 工具安装 bilibili-cli # 或：pipx 安装 bilibili-cli # 如果需要音频提取支持（需要 PyAV） uv 工具安装 "bilibili-cli[audio]" # 或：pipx 安装 "bilibili-cli[audio]"

身份验证 大多数读取命令无需登录。 字幕、收藏/关注/稍后观看/历史、动态和交互需要登录。 bili 状态 # 检查是否登录（退出 0 = 是，1 = 否） bili 登录 # 二维码登录（如果未认证） 身份验证自动检测本地浏览器 cookie（Chrome/Firefox/Edge/Brave）。 如果找到 cookie 且有效，则无需手动登录。 凭据保存到 ~/.bilibili-cli/credential.json。

命令参考 视频 # 获取视频详细信息（接受 BV ID 或完整 URL） bili 视频 BV1ABcsztEcY bili 视频 https://www.bilibili.com/video/BV1ABcsztEcY # 选项 bili 视频 BV1ABcsztEcY -- 字幕 # 显示字幕（纯文本） bili 视频 BV1ABcsztEcY -- 字幕时间线 # 显示带时间戳的字幕 bili 视频 BV1ABcsztEcY -st -- 字幕格式 srt # 以 SRT 格式导出 bili 视频 BV1ABcsztEcY -- ai # 显示 B 站 AI 总结 bili 视频 BV1ABcsztEcY -- 评论 # 显示顶级评论 bili 视频 BV1ABcsztEcY -- 相关 # 显示相关视频 bili 视频 BV1ABcsztEcY -- yaml # 令牌高效的 YAML 输出 bili 视频 BV1ABcsztEcY -- json # 结构化 JSON 信封

用户 # 查找用户资料（按 UID 或用户名） bili 用户 946974 bili 用户 "影视飓风" # 列出用户的视频 bili 用户视频 946974 --max 20 bili 用户视频 "影视飓风" --yaml

搜索 # 搜索用户（默认） bili 搜索 "关键词" # 搜索视频 bili 搜索 "关键词" -- 类型视频 # 分页和限制 bili 搜索 "关键词" -- 类型视频 --max 5 bili 搜索 "关键词" -- 页 2

发现 bili 热门 # 流行视频 bili 热门 -- 页 2 --max 10 # 第 2 页，限制 10 bili 排行 # 站点范围内的排名（3 天） bili 排行 -- 天 7 --max 30 # 7 天排名，前 30 bili 动态 # 动态时间线（需要登录） bili 动态 -- 偏移 1234567890 # 下一页通过返回光标 bili 我的动态 # 我发布的动态（需要登录） bili 动态发布 "hello" # 发布文本动态（需要写入凭据） bili 动态删除 123456789 # 删除一个动态（需要写入凭据）

集合（需要登录） bili 收藏 # 列出收藏夹 bili 收藏 -- 页 2 # 文件夹中的视频 bili 关注 # 关注列表 bili 稍后观看 # 稍后观看列表 bili 历史 # 观看历史

音频提取 需要 bilibili-cli[audio] 额外（PyAV）。 使用 uv 工具安装 "bilibili-cli[audio]"。 # 下载音频并将其拆分为 ASR 准备好的 WAV 段（每个 25s，16kHz 单声道） bili 音频 BV1ABcsztEcY # 拆分到 /tmp/bilibili-cli/{title}/ bili 音频 BV1ABcsztEcY -- 段 60 # 每段 60s bili 音频 BV1ABcsztEcY -- 不拆分 # 完整的 m4a 文件，无拆分 bili 音频 BV1ABcsztEcY -o ~/data/ # 自定义输出目录

交互（需要登录） bili 喜欢 BV1ABcsztEcY # 喜欢一个视频 bili 喜欢 BV1ABcsztEcY -- 取消 # 取消喜欢 bili 硬币 BV1ABcsztEcY # 给 1 硬币 bili 硬币 BV1ABcsztEcY -n 2 # 给 2 硬币 bili 三连 BV1ABcsztEcY # 一键三连（喜欢 + 硬币 + 收藏） bili 取关 946974 # 取关 UID

账户 bili 状态 # 快速登录检查 bili 状态 -- yaml # 结构化认证状态 bili 我是谁 # 详细个人资料信息 bili 我是谁 -- yaml # 个人资料作为 YAML bili 我是谁 -- json # 个人资料作为 JSON bili 登录 # 二维码登录 bili 退出 # 清除凭据

结构化输出 主要查询命令支持 --yaml 和 --json 以实现机器可读输出。 更喜欢 YAML 用于代理： bili 状态 -- yaml # 快速结构化认证检查 bili 视频 BV1ABcsztEcY -- yaml # 首选用于 AI 代理 bili 热门 --max 5 -- yaml