微信扫一扫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) |
环境变量
# 覆盖默认输出模式
OUTPUT=yaml|json|rich|auto
认证说明
bilibili-cli采用3层认证策略:
- 已保存凭证 - 从
~/.bilibili-cli/credential.json加载 - 浏览器Cookies - 自动从Chrome/Firefox/Edge/Brave提取
- 扫码登录 -
bili login在终端显示二维码
权限说明:
- 大部分命令无需登录
- 字幕/收藏/关注/稍后观看/历史/动态需要登录
- 点赞/投币/三连/取关/发布动态需要写入权限
常见问题排查
| 问题 | 解决方案 |
|------|----------|
| 需要登录 | 运行 bili login 扫码,或确保浏览器已登录bilibili |
| HTTP 412 限流 | 等待后重试,或减少 --max 数量 |
| 无法提取BV号 | 检查BV格式,必须是BV+10位字符 |
| NetworkError | 检查网络,代理需支持目标域名 |
| 不支持写操作 | 重新 bili login 获取完整权限 |
安装方式
# 推荐: uv工具(快速隔离)
uv tool install bilibili-cli
# 或: pipx
pipx install bilibili-cli
# 需要音频功能
uv tool install "bilibili-cli[audio]"
pipx install "bilibili-cli[audio]"
使用示例
示例1: 获取视频详情(AI友好格式)
bili video BV1ABcsztEcY --yaml
示例2: 下载音频并分割为ASR片段
bili audio BV1ABcsztEcY --segment 25 -o ./audio/
示例3: 搜索并获取视频评论
bili search "Python教程" --type video --max 10
bili video BV1xxx --comments --yaml
示例4: 获取UP主全部视频
bili user-videos 946974 --max 50
示例5: 查看热门榜单
bili hot --page 1 --max 20
bili rank --day 7
示例6: 登录并执行互动
bili login
bili triple BV1ABcsztEcY --json