Yq Bilibili Skill

哔哩哔哩CLI工具，支持抓取视频详情/字幕/AI摘要/评论/相关视频，提取音频并分割为ASR-ready WAV片段，获取用户资料/视频列表/关注列表，搜索用户或视频，热门视频/全站排行榜，动态时间线，收藏夹/稍后观看/观看历史，点赞/投币/一键三连等互动操作。当用户要求获取B站视频信息、下载音频、查询UP主信息、搜索B站内容、获取热门榜单、查看收藏夹、执行B站互动操作时使用。

yq-bilibili-skill - 哔哩哔哩数据抓取与互动

简介

这是一个基于 bilibili-cli 的Agent Skill，提供哔哩哔哩视频、音频、用户信息抓取以及互动功能的完整解决方案。

核心功能

1. 视频相关功能

功能	命令	说明
视频详情	bili video <BV号>	获取视频基本信息
字幕	bili video <BV号> --subtitle	获取字幕(纯文本)
字幕时间轴	bili video <BV号> --subtitle-timeline	获取带时间轴的字幕
导出SRT	bili video <BV号> -st --subtitle-format srt	导出为SRT格式
AI摘要	bili video <BV号> --ai	获取AI生成的视频摘要
评论	bili video <BV号> --comments	获取热门评论
相关视频	bili video <BV号> --related	获取相关视频推荐

2. 音频提取功能

功能	命令	说明
下载并分割	bili audio <BV号>	下载音频并分割为25秒WAV片段
自定义片段时长	bili audio <BV号> --segment 60	设置60秒分割
完整音频	bili audio <BV号> --no-split	保持完整m4a格式
自定义输出目录	bili audio <BV号> -o ~/data/	指定输出路径

3. 用户相关功能

功能	命令	说明
UP主资料	bili user <UID>	获取UP主个人资料
搜索用户	bili user "<用户名>"	按名称搜索用户
UP主视频列表	bili user-videos <UID> --max 20	获取视频列表(最多20个)

4. 发现与搜索功能

功能	命令	说明
热门视频	bili hot	获取热门视频(第1页)
分页热门	bili hot --page 2 --max 10	第2页,前10条
全站排行榜	bili rank	3日排行榜
自定义天数	bili rank --day 7 --max 30	7日榜,前30
搜索用户	bili search "<关键词>"	搜索用户
搜索视频	bili search "<关键词>" --type video --max 5	搜索视频
搜索分页	bili search "<关键词>" --page 2	下一页
动态时间线	bili feed	获取关注动态
分页动态	bili feed --offset <cursor>	通过cursor翻页

5. 收藏与历史功能

功能	命令	说明
收藏夹列表	bili favorites	获取收藏夹列表
收藏夹内容	bili favorites --page 2	收藏夹视频(第2页)
关注列表	bili following	获取关注列表
稍后观看	bili watch-later	获取稍后观看列表
观看历史	bili history	获取观看历史

6. 互动功能

功能	命令	说明
点赞	bili like <BV号>	给视频点赞
投币	bili coin <BV号>	给视频投币
一键三连	bili triple <BV号>	点赞+投币+收藏
取关	bili unfollow <UID>	取消关注

7. 认证相关

功能	命令	说明
登录状态	bili status	检查登录状态
扫码登录	bili login	QR码登录
个人信息	bili whoami	详细个人资料

输出格式

所有命令支持以下输出格式:

参数	说明
--yaml	YAML格式输出(推荐用于AI处理)
--json	JSON格式输出(结构化数据)

通用参数

参数	说明
--page N	分页号
--max N	最大结果数
--offset N	翻页游标
-o PATH	输出目录
--day N	排行榜天数(3或7)

环境变量

bash

# 覆盖默认输出模式
OUTPUT=yaml|json|rich|auto

认证说明

bilibili-cli采用3层认证策略:

1. 已保存凭证 - 从 ~/.bilibili-cli/credential.json 加载
2. 浏览器Cookies - 自动从Chrome/Firefox/Edge/Brave提取
3. 扫码登录 - bili login 在终端显示二维码

权限说明:

• 大部分命令无需登录
• 字幕/收藏/关注/稍后观看/历史/动态需要登录
• 点赞/投币/三连/取关/发布动态需要写入权限

常见问题排查

问题	解决方案
需要登录	运行 bili login 扫码,或确保浏览器已登录bilibili
HTTP 412 限流	等待后重试,或减少 --max 数量
无法提取BV号	检查BV格式,必须是BV+10位字符
NetworkError	检查网络,代理需支持目标域名
不支持写操作	重新 bili login 获取完整权限

安装方式

bash

# 推荐: uv工具(快速隔离)
uv tool install bilibili-cli

# 或: pipx
pipx install bilibili-cli

# 需要音频功能
uv tool install "bilibili-cli[audio]"
pipx install "bilibili-cli[audio]"

使用示例

示例1: 获取视频详情(AI友好格式)

bash

bili video BV1ABcsztEcY --yaml

示例2: 下载音频并分割为ASR片段

bash

bili audio BV1ABcsztEcY --segment 25 -o ./audio/

示例3: 搜索并获取视频评论

bash

bili search "Python教程" --type video --max 10
bili video BV1xxx --comments --yaml

示例4: 获取UP主全部视频

bash

bili user-videos 946974 --max 50

示例5: 查看热门榜单

bash

bili hot --page 1 --max 20
bili rank --day 7

示例6: 登录并执行互动

bash

bili login
bili triple BV1ABcsztEcY --json