name: bilibili-hub
description: >
A skill for reading and writing Bilibili data with Python + UV, using bilibili-api-python + aiohttp.
It automatically obtains cookies through browser_use get_cookies for authentication, so no manual copying is required.
Supports video details, subtitles, AI summaries, comments, user profiles, search, popular videos/rankings, following dynamics feed,
favorites, Watch Later, viewing history, interactions (likes, coins, triple action), publishing and deleting dynamics, and more.
When a user mentions "Bilibili," "bilibili," "Bilibili videos," "Bilibili popular," "bilibili-hub,"
"get Bilibili data," "Bilibili subtitles," "Bilibili comments," "Bilibili favorites," "Bilibili dynamics,"
or any scenario that requires programmatically reading or writing Bilibili content, this skill must be triggered.
bilibili-hub
Modified from: jackwener/bilibili-cli (Apache-2.0)
This skill simplifies and modifies the original repository as follows:
- Removed the
browser-cookie3 / click / rich / PyYAML / qrcode dependencies
- Changed cookie authentication to accept a
dict directly or read from environment variables, without automatic browser extraction
- Removed the CLI layer (
commands/), QR login, formatters, and related components
- Kept all API methods and wrapped them uniformly as synchronous interfaces (
asyncio.run)
- Core dependency:
bilibili-api-python, a third-party SDK that reverse engineers the Bilibili API
- In the Minis environment, cookies are obtained automatically through
browser_use get_cookies
File Structure
/var/minis/skills/bilibili-hub/
├── SKILL.md
├── pyproject.toml # bilibili-api-python + aiohttp
└── scripts/
├── __init__.py
├── exceptions.py # 6 structured exception types
├── payloads.py # Data structure normalization (normalize_* functions)
└── client.py # BiliClient core class (all API methods)
Authentication Methods
The Bilibili Web API uses three key cookies:
| Cookie | Description |
|---|
SESSDATA | User session (required for read operations) |
bili_jct | CSRF token (required for write operations: likes, coins, posting dynamics, etc.) |
DedeUserID | User ID (recommended) |
buvid3 | Device ID (recommended; reduces the likelihood of triggering risk control) |
Method 1: Automatically retrieve via browser_use (preferred in Minis environments)
- Use
browser_use navigate to open https://www.bilibili.com and confirm that you are logged in.
- Use
browser_use get_cookies to retrieve cookies (raw values do not appear in the conversation).
- Load the offload env file:
. /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"
Note: get_cookies only applies to the current page's domain. Navigate to https://www.bilibili.com before calling it.
Method 2: Manually retrieve from browser DevTools
- Log in to Bilibili, then open DevTools -> Application -> Cookies ->
https://www.bilibili.com.
- Find the values of
SESSDATA, bili_jct, and DedeUserID.
- Store them in the Minis environment variables:
BILI_SESSDATA / BILI_JCT / BILI_USERID.
Ways to pass cookies (three methods)
# Method 1: From environment variables (recommended)
client = BiliClient.from_env()
# Method 2: Pass a dict directly
client = BiliClient({
"SESSDATA": os.environ["BILI_SESSDATA"],
"bili_jct": os.environ["BILI_JCT"],
"DedeUserID": os.environ["BILI_USERID"],
})
# Method 3: Read-only operations (no write permissions required)
client = BiliClient({"SESSDATA": os.environ["BILI_SESSDATA"]})
Quick Start
Environment setup
cd /var/minis/skills/bilibili-hub
uv sync
Calling as a Python library
import os, json, sys
sys.path.insert(0, "/var/minis/skills/bilibili-hub")
from scripts.client import BiliClient
client = BiliClient.from_env()
# Current user information
me = client.whoami()
print("User:", me.get("name"), "UID:", me.get("mid"))
# Search videos
videos = client.search_videos("Python Tutorial", count=5)
for v in videos:
print(f" {v['bvid']} {v['title']} ({v['duration']})")
# Get video details (including subtitles)
detail = client.get_video("BV1xx411c7mD", subtitle=True)
print(detail["video"]["title"])
print(detail["subtitle"]["text"][:200])
# Popular videos
hot = client.get_hot(count=10)
for v in hot:
print(f" {v['bvid']} {v['title']} 👁{v['stats']['view']}")
API Method Quick Reference
Account
| Method | Description |
|---|
whoami() | Get information about the currently logged-in user |
Video
| Method | Description |
|---|
get_video(bvid, *, subtitle, subtitle_timeline, ai_summary, comments, related) | Get video details (optional subtitles/AI summary/comments/related videos) |
bvid supports a BV number or full URL and is extracted automatically.
Users
| Method | Description |
|---|
get_user(uid) | Get user profile information + following/follower counts |
get_user_videos(uid, count=20) | Get videos posted by a user |
Search
| Method | Description |
|---|
search_videos(keyword, page=1, count=20) | Search videos |
search_users(keyword, page=1) | Search users |
Discover
| Method | Description |
|---|
get_hot(page=1, count=20) | Site-wide popular videos |
get_rank(day=3, count=50) | Site-wide rankings (day: 1/3/7) |
get_feed(offset=0) | Following dynamics feed (login required) |
get_my_dynamics(offset=0) | Dynamics I published (login required) |
post_dynamic(text) | Post a text dynamic (login + bili_jct required) |
delete_dynamic(dynamic_id) | Delete a dynamic (login + bili_jct required) |
Favorites / History
| Method | Description |
|---|
get_favorites() | Get the favorites folder list (login required) |
get_favorites(folder_id) | Get videos in a favorites folder |
get_following(page=1) | Get the following list (login required) |
get_watch_later() | Get the Watch Later list (login required) |
get_history() | Get viewing history (login required) |
Download
| Method | Description |
|---|
download_video(bvid, output_dir, filename=None) | Download the full video (mp4), automatically handling DASH merging |
download_audio(bvid, output_dir, filename=None) | Download only the audio stream (m4a), suitable for ASR transcription |
Download process:
- DASH streams (common): download the video stream and audio stream separately -> merge with
ffmpeg copy -> if merging fails, keep the silent video
- FLV/MP4 streams (rare): download directly, no merging required
- Without logging in, downloads are limited to 480P; after logging in, 1080P is available (premium members can download higher quality)
| Method | Description |
|---|
like(bvid) / like(bvid, undo=True) | Like / unlike (requires bili_jct) |
coin(bvid, num=1) | Give 1 or 2 coins (requires bili_jct) |
triple(bvid) | Perform the one-click triple action (requires bili_jct) |
unfollow(uid) | Unfollow a user (requires bili_jct) |
Error Handling
from scripts.exceptions import (
AuthenticationError, # Cookie missing or expired
RateLimitError, # Triggered risk control (412)
NotFoundError, # Video/user does not exist
NetworkError, # Network/timeout error
InvalidBvidError, # Invalid BV number format
BiliError, # Other API error (base class)
)
try:
detail = client.get_video("BV1xx411c7mD")
except AuthenticationError:
print("Cookie has expired. Please retrieve it again.")
except RateLimitError:
print("Risk control triggered. Try again later.")
except NotFoundError:
print("Video does not exist.")
except BiliError as e:
print(f"API error: {e}")
Important Notes
SESSDATA is the minimum requirement for read operations. Write operations (likes, coins, posting dynamics) also require bili_jct.- Cookies are usually valid for several days to several weeks. After they expire, retrieve them again through
browser_use get_cookies.
- Bilibili applies risk control to high-frequency requests (HTTP 412). An operation interval of at least 1 second is recommended.
bilibili-api-python is a community-maintained reverse-engineering project, and its interfaces may break when Bilibili updates.- Write operations (coins, triple action, etc.) cannot be reversed. Use them with caution.