bilibili-hub

改造来源：jackwener/bilibili-cli（Apache-2.0）

本技能在原仓库基础上做了以下简化与改造：

• 移除 browser-cookie3 / click / rich / PyYAML / qrcode 依赖
• Cookie 认证改为直接传入 dict 或从环境变量读取，不做浏览器自动提取
• 移除 CLI 层（commands/）、QR 登录、formatter 等
• 保留全部 API 方法，统一封装为同步接口（asyncio.run）
• 核心依赖 bilibili-api-python（逆向工程 B 站 API 的第三方 SDK）
• 在 Minis 环境中，Cookie 通过 browser_use get_cookies 自动获取

---

文件结构

/var/minis/skills/bilibili-hub/
├── SKILL.md
├── pyproject.toml          # bilibili-api-python + aiohttp
└── scripts/
    ├── __init__.py
    ├── exceptions.py       # 6 种结构化异常
    ├── payloads.py         # 数据结构规范化（normalize_* 函数）
    └── client.py           # BiliClient 核心类（全部 API 方法）

---

认证方式

B 站 Web API 使用三个关键 Cookie：

Cookie	说明
SESSDATA	用户 Session（必填，读操作）
bili_jct	CSRF Token（写操作必填：点赞/投币/发动态等）
DedeUserID	用户 ID（建议填写）
buvid3	设备 ID（建议填写，降低风控概率）

方法一：browser_use 自动获取（Minis 环境首选）

1. browser_use navigate 打开 https://www.bilibili.com，确认已登录
2. browser_use get_cookies 获取 Cookie（原始值不出现在对话中）
3. 加载 offload env 文件：

. /var/minis/offloads/env_cookies_www_bilibili_com_xxx.sh
export BILI_SESSDATA="$COOKIE_SESSDATA"
export BILI_JCT="$COOKIE_BILI_JCT"
export BILI_USERID="$COOKIE_DEDEUSERID"
export BILI_BUVID3="$COOKIE_BUVID3"

注意：get_cookies 仅对当前页面域名生效，需先 navigate 到 https://www.bilibili.com 再调用。

方法二：手动从浏览器 DevTools 获取

1. 登录 B 站，打开 DevTools → Application → Cookies → https://www.bilibili.com
2. 找到 SESSDATA、bili_jct、DedeUserID 的值
3. 存入 Minis 环境变量：BILI_SESSDATA / BILI_JCT / BILI_USERID

Cookie 传入方式（三种）

# 方式一：从环境变量（推荐）
client = BiliClient.from_env()

# 方式二：直接传入 dict
client = BiliClient({
    "SESSDATA":   os.environ["BILI_SESSDATA"],
    "bili_jct":   os.environ["BILI_JCT"],
    "DedeUserID": os.environ["BILI_USERID"],
})

# 方式三：仅读操作（无需写权限）
client = BiliClient({"SESSDATA": os.environ["BILI_SESSDATA"]})

---

快速开始

环境准备

cd /var/minis/skills/bilibili-hub
uv sync

作为 Python 库调用

import os, json, sys
sys.path.insert(0, "/var/minis/skills/bilibili-hub")
from scripts.client import BiliClient

client = BiliClient.from_env()

# 当前用户信息
me = client.whoami()
print("用户：", me.get("name"), "UID:", me.get("mid"))

# 搜索视频
videos = client.search_videos("Python 教程", count=5)
for v in videos:
    print(f"  {v['bvid']} {v['title']} ({v['duration']})")

# 获取视频详情（含字幕）
detail = client.get_video("BV1xx411c7mD", subtitle=True)
print(detail["video"]["title"])
print(detail["subtitle"]["text"][:200])

# 热门视频
hot = client.get_hot(count=10)
for v in hot:
    print(f"  {v['bvid']} {v['title']} 👁{v['stats']['view']}")

---

API 方法速查

账号

方法	说明
whoami()	获取当前登录用户信息

视频

方法	说明
get_video(bvid, *, subtitle, subtitle_timeline, ai_summary, comments, related)	获取视频详情（可选字幕/AI总结/评论/相关）

bvid 支持 BV 号或完整 URL，自动提取。

用户

方法	说明
get_user(uid)	获取用户主页信息 + 关注/粉丝数
get_user_videos(uid, count=20)	获取用户发布的视频

搜索

方法	说明
search_videos(keyword, page=1, count=20)	搜索视频
search_users(keyword, page=1)	搜索用户

发现

方法	说明
get_hot(page=1, count=20)	全站热门视频
get_rank(day=3, count=50)	全站排行榜（day: 1/3/7）
get_feed(offset=0)	关注动态 Feed（需登录）
get_my_dynamics(offset=0)	我发布的动态（需登录）
post_dynamic(text)	发布文字动态（需登录+bili_jct）
delete_dynamic(dynamic_id)	删除动态（需登录+bili_jct）

收藏 / 历史

方法	说明
get_favorites()	获取收藏夹列表（需登录）
get_favorites(folder_id)	获取收藏夹内视频
get_following(page=1)	获取关注列表（需登录）
get_watch_later()	稍后再看列表（需登录）
get_history()	观看历史（需登录）

下载

方法	说明
download_video(bvid, output_dir, filename=None)	下载完整视频（mp4），自动处理 DASH 合并
download_audio(bvid, output_dir, filename=None)	仅下载音频流（m4a），适合 ASR 转写

下载流程：

• DASH 流（主流）：分别下载视频流 + 音频流 → ffmpeg copy 合并 → 失败则保留无声视频
• FLV/MP4 流（少见）：直接下载，无需合并
• 未登录可下最高 480P；登录后可下 1080P（大会员可下更高画质）

方法	说明
like(bvid) / like(bvid, undo=True)	点赞 / 取消点赞（需bili_jct）
coin(bvid, num=1)	投币 1 或 2 枚（需bili_jct）
triple(bvid)	一键三连（需bili_jct）
unfollow(uid)	取消关注用户（需bili_jct）

---

错误处理

from scripts.exceptions import (
    AuthenticationError,  # Cookie 缺失或过期
    RateLimitError,       # 触发风控（412）
    NotFoundError,        # 视频/用户不存在
    NetworkError,         # 网络/超时错误
    InvalidBvidError,     # BV 号格式错误
    BiliError,            # 其他 API 错误（基类）
)

try:
    detail = client.get_video("BV1xx411c7mD")
except AuthenticationError:
    print("Cookie 已过期，请重新获取")
except RateLimitError:
    print("触发风控，稍后重试")
except NotFoundError:
    print("视频不存在")
except BiliError as e:
    print(f"API 错误：{e}")

---

注意事项

• SESSDATA 是读操作的最低要求；写操作（点赞/投币/发动态）还需要 bili_jct
• Cookie 有效期通常数天至数周，过期后需重新通过 browser_use get_cookies 获取
• B 站对高频请求有风控（HTTP 412），建议操作间隔 ≥1 秒
• bilibili-api-python 是社区维护的逆向工程项目，接口可能随 B 站更新失效
• 写操作（投币/三连等）不可逆，请谨慎调用