Bilibili
Browse trending videos, view video details, read comments, search content, view user profiles, and interact with Bilibili (B站).
Skill Directory
<SKILL_DIR> is the directory containing this SKILL.md file. Determine it ONCE at the start and reuse it.
Setup (run FIRST — every time, before any operation)
You MUST complete this setup before running any script. Do NOT skip this step.
sig status bilibili 2>&1
Check the JSON output fields configured and valid:
configured: false → run Provider Setup below. Do NOT proceed without completing it.valid: false (but configured: true) → run sig login bilibili, then re-check.valid: true → detect proxy (see below), then execute the user's request.
Provider Setup
- Read
<SKILL_DIR>/references/provider-config.yaml
- Append the provider block to
~/.sig/config.yaml under providers:
- Ask the user: "Do you need a proxy to access this site?" — if yes, add
networkProxy: <url> under the provider in config.yaml
- Run
sig login bilibili (with --network-proxy <url> if proxy was specified)
- Verify: run
sig status bilibili again — must show valid: true before proceeding
Proxy Detection (after provider is valid)
grep -A15 "^\s*bilibili:" ~/.sig/config.yaml | grep networkProxy | awk '{print $2}'
If this outputs a URL, prefix ALL python3 commands with HTTPS_PROXY=<url> HTTP_PROXY=<url>.
If using socks5, convert to socks5h for python (e.g. socks5://... → socks5h://...).
If empty, no proxy needed.
Running Scripts
All scripts require setup to be completed first (see above).
Read operations — use sig run to inject cookie (enables authenticated features):
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_hot.py --cookie "$SIG_BILIBILI_COOKIE" --limit 10'
Write operations — require sig run (cookie is mandatory):
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_like.py --cookie "$SIG_BILIBILI_COOKIE" --aid 123456'
Env var: SIG_BILIBILI_COOKIE
On auth error (401/403): run sig login bilibili automatically (no user prompt), then retry.
Scripts Reference
All scripts are in this skill's scripts/ directory. Run via Bash tool.
Read Operations
| Script | Purpose | Auth |
|---|
bilibili_video.py | Video details by BV | None |
bilibili_hot.py | Hot/trending videos | None |
bilibili_popular.py | Popular videos | None |
bilibili_ranking.py | Ranking by category | None |
bilibili_search.py | Search videos/users | None |
bilibili_comments.py | Video comments | None |
bilibili_user.py | User profile + vids | None |
bilibili_dynamic.py | Dynamic feed (动态) | Required |
bilibili_me.py | Current user profile | Required |
bilibili_history.py | Watch history | Required |
bilibili_subtitle.py | Video subtitles | None |
Write Operations
| Script | Purpose | Auth |
|---|
bilibili_like.py | Like/unlike a video | Required |
bilibili_coin.py | Give coins to video | Required |
bilibili_favorite.py | Favorite/unfavorite | Required |
bilibili_video.py
--bvid ID Video BV ID (e.g. BV1xx411c7mD) (required)
bilibili_hot.py
--limit N Max videos to return (default: 20)
--page N Page number (default: 1)
bilibili_popular.py
--limit N Max videos to return (default: 20)
--page N Page number (default: 1)
bilibili_ranking.py
--category NAME Category: all, anime, music, dance, game, tech, knowledge, life, food, animal, car, fashion, entertainment, movie, tv (default: all)
--limit N Max videos to return (default: 20)
bilibili_search.py
--keyword TEXT Search keyword (required)
--type TYPE Search type: video, user (default: video)
--page N Page number (default: 1)
--limit N Max results (default: 20)
bilibili_comments.py
--bvid ID Video BV ID (required)
--limit N Max comments to return (default: 20)
--page N Page number (default: 1)
bilibili_user.py
--mid N User mid (numeric ID) (required)
--include-videos Include recent videos (flag)
bilibili_dynamic.py
--cookie COOKIE Bilibili session cookie (required)
--limit N Max items to return (default: 20)
--offset TOKEN Pagination offset from previous response
bilibili_me.py
--cookie COOKIE Bilibili session cookie (required)
bilibili_history.py
--cookie COOKIE Bilibili session cookie (required)
--limit N Max items to return (default: 20)
--view-at N Cursor from previous response for pagination
bilibili_subtitle.py
--bvid ID Video BV ID (required)
--lang CODE Subtitle language code (e.g. zh-CN, en-US, ai-zh). Default: first available
--cookie COOKIE Bilibili session cookie (may be needed for some videos)
bilibili_like.py
--cookie COOKIE Bilibili session cookie (required)
--aid N Video aid (numeric ID) (required)
--undo Unlike instead of like (flag)
bilibili_coin.py
--cookie COOKIE Bilibili session cookie (required)
--aid N Video aid (numeric ID) (required)
--multiply N Number of coins: 1 or 2 (default: 1)
bilibili_favorite.py
--cookie COOKIE Bilibili session cookie (required)
--aid N Video aid (numeric ID) (required)
--folder-id N Favorites folder ID (optional, defaults to first folder)
--undo Remove from favorites instead of adding (flag)
Safety
Write operations are visible to the user's Bilibili account. Like and favorite are reversible via --undo. Coins cannot be taken back once given.
Always confirm with the user before calling bilibili_coin.py since coins are a limited, non-refundable currency on Bilibili.
Key Concepts
BV IDs — Bilibili videos are identified by BV IDs (e.g. BV1xx411c7mD). Most read scripts accept BV IDs directly.
AIDs — Numeric video IDs used by write operations. Get the aid from video details (bilibili_video.py).
WBI Signing — Search and user profile endpoints require WBI parameter signing. The client handles this automatically.
CSRF Token — Write operations need a bili_jct CSRF token extracted from the session cookie. The client extracts it automatically.
Categories — Ranking supports categories: all (0), anime (1), music (3), dance (129), game (4), tech (188), knowledge (36), life (160), food (211), animal (217), car (223), fashion (155), entertainment (5), movie (181), tv (177).
Pagination — List endpoints accept --page for page number and --limit for page size.
Error Handling
| Error | Cause | Fix |
|---|
| HTTP_412 | Request blocked by anti-spam | Wait and retry, or use different IP |
| HTTP_404 | Video/user not found | Check the ID is correct |
| AUTH_REQUIRED | No cookie for write op | Auto-run sig login (no user prompt needed), retry |
| NO_CSRF | No bili_jct in cookie | Auto-run sig login (no user prompt needed), retry |
| API_ERROR | Bilibili returned error code | Check error message for details |
Workflow Examples
Browse hot videos
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_hot.py --cookie "$SIG_BILIBILI_COOKIE" --limit 10'- Next page:
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_hot.py --cookie "$SIG_BILIBILI_COOKIE" --limit 10 --page 2'
Get video details
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_video.py --cookie "$SIG_BILIBILI_COOKIE" --bvid BV1xx411c7mD'
Search for videos
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_search.py --cookie "$SIG_BILIBILI_COOKIE" --keyword "machine learning" --limit 10'
Search for users
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_search.py --cookie "$SIG_BILIBILI_COOKIE" --keyword "username" --type user'
Read video comments
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_comments.py --cookie "$SIG_BILIBILI_COOKIE" --bvid BV1xx411c7mD --limit 20'
View ranking
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_ranking.py --cookie "$SIG_BILIBILI_COOKIE" --category music --limit 10'
Like a video
- Get the aid:
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_video.py --cookie "$SIG_BILIBILI_COOKIE" --bvid BV1xx411c7mD' (check the aid field)
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_like.py --cookie "$SIG_BILIBILI_COOKIE" --aid 123456'
Give coins
- Confirm with user first — coins are non-refundable
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_coin.py --cookie "$SIG_BILIBILI_COOKIE" --aid 123456 --multiply 1'
Add to favorites
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_favorite.py --cookie "$SIG_BILIBILI_COOKIE" --aid 123456 --folder-id 100'
View my profile
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_me.py --cookie "$SIG_BILIBILI_COOKIE"'
Browse dynamic feed
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_dynamic.py --cookie "$SIG_BILIBILI_COOKIE" --limit 10'- Next page:
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_dynamic.py --cookie "$SIG_BILIBILI_COOKIE" --offset TOKEN'
View watch history
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_history.py --cookie "$SIG_BILIBILI_COOKIE" --limit 20'
Get video subtitles
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_subtitle.py --cookie "$SIG_BILIBILI_COOKIE" --bvid BV1xx411c7mD'- Choose language:
sig run bilibili -- bash -c 'python3 <SKILL_DIR>/scripts/bilibili_subtitle.py --cookie "$SIG_BILIBILI_COOKIE" --bvid BV1xx411c7mD --lang en-US'