Skip to content

archibate/dotfiles-opencode / skills/bilibili-api

bilibili-api

Flagged

This skill should be used when the user asks to "use bilibili API", "download bilibili video", "get bilibili user info", "list bilibili favorites", "send bilibili danmaku", "upload video to bilibili", "monitor bilibili live room", "search bilibili", "get bilibili comments", or needs guidance on the bilibili_api Python library usage, authentication, API endpoints, or workflow patterns.

FileKindSize
SKILL.mdskill md8.3 KB
references/api-modules.mdmarkdown6.4 KB
references/common-patterns.mdmarkdown8.6 KB
references/configuration.mdmarkdown4.8 KB
references/credential-setup.mdmarkdown6.1 KB
references/docs/.gitignoreother13 B
references/docs/.nojekyllother0 B
references/docs/DEPLOY_LOCALHOST.mdmarkdown310 B
references/docs/README.mdmarkdown9.9 KB
references/docs/_sidebar.mdmarkdown4.7 KB
references/docs/b23tv.mdmarkdown448 B
references/docs/configuration.mdmarkdown4.3 KB
references/docs/examples/activity.mdmarkdown960 B
references/docs/examples/app.mdmarkdown127 B
references/docs/examples/article.mdmarkdown918 B
references/docs/examples/article_category.mdmarkdown648 B
references/docs/examples/ass.mdmarkdown727 B
references/docs/examples/audio.mdmarkdown1.8 KB
references/docs/examples/audio_uploader.mdmarkdown975 B
references/docs/examples/bangumi.mdmarkdown3.8 KB
references/docs/examples/black_room.mdmarkdown350 B
references/docs/examples/channel_series.mdmarkdown787 B
references/docs/examples/cheese.mdmarkdown152 B
references/docs/examples/client.mdmarkdown183 B
references/docs/examples/comment.mdmarkdown2.2 KB
references/docs/examples/creative_center.mdmarkdown288 B
references/docs/examples/dynamic.mdmarkdown2.0 KB
references/docs/examples/emoji.mdmarkdown802 B
references/docs/examples/favorite_list.mdmarkdown406 B
references/docs/examples/festival.mdmarkdown3.0 KB
references/docs/examples/game.mdmarkdown1.4 KB
references/docs/examples/garb.mdmarkdown3.2 KB
references/docs/examples/homepage.mdmarkdown127 B
references/docs/examples/hot.mdmarkdown263 B
references/docs/examples/interactive_video.mdmarkdown7.9 KB
references/docs/examples/live.mdmarkdown4.0 KB
references/docs/examples/live_area.mdmarkdown349 B
references/docs/examples/login_v2.mdmarkdown5.1 KB
references/docs/examples/manga.mdmarkdown1.2 KB
references/docs/examples/music.mdmarkdown727 B
references/docs/examples/note.mdmarkdown355 B
references/docs/examples/opus.mdmarkdown1.9 KB
references/docs/examples/rank.mdmarkdown122 B
references/docs/examples/search.mdmarkdown1.3 KB
references/docs/examples/session.mdmarkdown778 B
references/docs/examples/show.mdmarkdown255 B
references/docs/examples/topic.mdmarkdown159 B
references/docs/examples/user.mdmarkdown2.5 KB
references/docs/examples/video.mdmarkdown3.8 KB
references/docs/examples/video_tag.mdmarkdown174 B
references/docs/examples/video_uploader.mdmarkdown2.0 KB
references/docs/examples/video_zone.mdmarkdown279 B
references/docs/examples/vote.mdmarkdown133 B
references/docs/examples/watchroom.mdmarkdown662 B
references/docs/get-credential.mdmarkdown3.2 KB
references/docs/history.htmlother1.5 KB
references/docs/history.mdmarkdown123 B
references/docs/index.htmlother2.2 KB
references/docs/ivifile.mdmarkdown3.9 KB
references/docs/logo-small.pngbinary12.2 KB
references/docs/logo.pngbinary88.6 KB
references/docs/modules/README.mdmarkdown432 B
references/docs/modules/activity.mdmarkdown1.0 KB
references/docs/modules/app.mdmarkdown1.3 KB
references/docs/modules/article.mdmarkdown4.8 KB
references/docs/modules/article_category.mdmarkdown2.1 KB
references/docs/modules/ass.mdmarkdown8.2 KB
references/docs/modules/audio.mdmarkdown3.2 KB
references/docs/modules/audio_uploader.mdmarkdown7.5 KB
references/docs/modules/bangumi.mdmarkdown23.6 KB
references/docs/modules/bilibili_api.mdmarkdown38.4 KB
references/docs/modules/black_room.mdmarkdown6.1 KB
references/docs/modules/channel_series.mdmarkdown4.4 KB
references/docs/modules/cheese.mdmarkdown7.3 KB
references/docs/modules/client.mdmarkdown508 B
references/docs/modules/comment.mdmarkdown7.2 KB
references/docs/modules/creative_center.mdmarkdown14.1 KB
references/docs/modules/dynamic.mdmarkdown13.9 KB
references/docs/modules/emoji.mdmarkdown1.6 KB
references/docs/modules/favorite_list.mdmarkdown10.2 KB
references/docs/modules/festival.mdmarkdown771 B
references/docs/modules/game.mdmarkdown3.1 KB
references/docs/modules/garb.mdmarkdown5.8 KB
references/docs/modules/homepage.mdmarkdown2.2 KB
references/docs/modules/hot.mdmarkdown1.6 KB
references/docs/modules/interactive_video.mdmarkdown13.3 KB
references/docs/modules/live.mdmarkdown20.2 KB
references/docs/modules/live_area.mdmarkdown2.2 KB
references/docs/modules/login_v2.mdmarkdown6.0 KB
references/docs/modules/manga.mdmarkdown4.0 KB
references/docs/modules/music.mdmarkdown3.5 KB
references/docs/modules/note.mdmarkdown4.3 KB
references/docs/modules/opus.mdmarkdown3.3 KB
references/docs/modules/rank.mdmarkdown6.8 KB
references/docs/modules/search.mdmarkdown5.9 KB
references/docs/modules/session.mdmarkdown6.9 KB
references/docs/modules/show.mdmarkdown3.2 KB
references/docs/modules/topic.mdmarkdown2.7 KB
references/docs/modules/user.mdmarkdown25.9 KB
references/docs/modules/video.mdmarkdown28.4 KB
references/docs/modules/video_tag.mdmarkdown1.7 KB
references/docs/modules/video_uploader.mdmarkdown9.9 KB
references/docs/modules/video_zone.mdmarkdown6.8 KB
references/docs/modules/vote.mdmarkdown3.2 KB
references/docs/modules/watchroom.mdmarkdown4.4 KB
references/docs/package-lock.jsonmanifest125.8 KB
references/docs/refresh_cookies.mdmarkdown674 B
references/docs/request_client.mdmarkdown11.1 KB
references/docs/search.jsscript6.4 KB
references/docs/sync-executor.mdmarkdown471 B
references/docs/target/npmlist.jsonconfig268 B
references/docs/theme.cssother15.4 KB
references/docs/vote_id.mdmarkdown2.0 KB
references/docs/vote_source.pngbinary41.8 KB
references/live-guide.mdmarkdown5.1 KB
references/self-update.mdmarkdown5.4 KB
references/upload-guide.mdmarkdown5.9 KB
references/user-guide.mdmarkdown4.7 KB
references/video-guide.mdmarkdown6.0 KB
scripts/credential_check.pyscript3.0 KB
scripts/quickstart.pyscript1.2 KB

references/credential-setup.md

View on GitHub
# Credential Setup

## Credential Class

The `Credential` class stores authentication cookies required for Bilibili API access.

```python
from bilibili_api import Credential

credential = Credential(
    sessdata="...",        # Required for GET (read) operations
    bili_jct="...",        # Required for POST (write) operations
    buvid3="...",          # Device ID v3 (auto-generated if omitted)
    buvid4="...",          # Device ID v4 (optional)
    dedeuserid="...",      # User UID (rarely needed)
    ac_time_value="...",   # For cookie refresh only
    proxy="...",           # Optional proxy for this credential
)
```

## Cookie Field Reference

| Field | Cookie Name | Purpose | When Required |
|-------|-------------|---------|---------------|
| `sessdata` | `SESSDATA` | User session for reading user data | GET operations on user-specific data |
| `bili_jct` | `bili_jct` | CSRF token for modifying data | POST operations (like, comment, upload) |
| `buvid3` | `buvid3` | Device fingerprint v3 | Some APIs require it; anti-bot |
| `buvid4` | `buvid4` | Device fingerprint v4 | Optional, related to risk control |
| `dedeuserid` | `DedeUserID` | User UID | Rarely needed |
| `ac_time_value` | (localStorage) | Token for cookie refresh | Only for `credential.refresh()` |

## Browser Extraction

Extract cookies from a logged-in browser session at `bilibili.com`:

### Chrome / Edge

1. Open bilibili.com and log in
2. Press `F12` to open DevTools
3. Go to **Application** tab (Chrome) or **应用程序** tab (Edge)
4. Navigate to **Storage → Cookies → https://www.bilibili.com**
5. Copy values for: `SESSDATA`, `bili_jct`, `buvid3`, `DedeUserID`

### Firefox

1. Open bilibili.com and log in
2. Press `F12` to open DevTools
3. Go to **Storage** tab
4. Navigate to **Cookies → https://www.bilibili.com**
5. Copy values for: `SESSDATA`, `bili_jct`, `buvid3`, `DedeUserID`

### ac_time_value (for cookie refresh)

1. Open bilibili.com while logged in
2. Press `F12` to open DevTools
3. Go to **Console** tab
4. Run: `window.localStorage.ac_time_value`
5. Copy the returned value

## Credential Validation

```python
# Check if fields are present
credential.has_sessdata()    # bool
credential.has_bili_jct()    # bool
credential.has_buvid3()      # bool
credential.has_buvid4()      # bool
credential.has_dedeuserid()  # bool
credential.has_ac_time_value()  # bool

# Raise exception if missing (useful for validation)
credential.raise_for_no_sessdata()
credential.raise_for_no_bili_jct()
credential.raise_for_no_buvid3()

# Get all cookies as dict
cookies = credential.get_cookies()
```

## Programmatic Login

### QR Code Login

```python
from bilibili_api import login_v2, sync
import time

async def qr_login():
    qr = login_v2.QrCodeLogin(platform=login_v2.QrCodeLoginChannel.WEB)
    await qr.generate_qrcode()

    # Print QR code to terminal
    print(qr.get_qrcode_terminal())

    # Poll until scanned
    while not qr.has_done():
        state = await qr.check_state()
        print(f"Status: {state}")
        time.sleep(1)

    # Get credential
    credential = qr.get_credential()
    print(credential.get_cookies())
    return credential

sync(qr_login())
```

### Password Login

Requires Geetest captcha verification:

```python
from bilibili_api import Geetest, login_v2, sync

async def password_login():
    # Complete Geetest captcha
    gee = Geetest()
    await gee.generate_test()
    gee.start_geetest_server()
    print(f"Open: {gee.get_geetest_server_url()}")

    while not gee.has_done():
        pass
    gee.close_geetest_server()

    # Login with password
    cred = await login_v2.login_with_password(
        username="phone_or_email",
        password="password",
        geetest=gee
    )

    # Handle security check if needed
    if isinstance(cred, login_v2.LoginCheck):
        # Additional verification required
        gee2 = Geetest()
        await gee2.generate_test(type_=GeetestType.VERIFY)
        # ... complete verification
        await cred.send_sms(gee2)
        code = input("SMS code: ")
        cred = await cred.complete_check(code)

    return cred
```

### SMS Login

```python
from bilibili_api import Geetest, login_v2, sync

async def sms_login():
    # Complete Geetest first
    gee = Geetest()
    await gee.generate_test()
    gee.start_geetest_server()
    print(f"Open: {gee.get_geetest_server_url()}")
    while not gee.has_done():
        pass
    gee.close_geetest_server()

    # Send SMS
    phone = login_v2.PhoneNumber("13800138000", "+86")
    captcha_id = await login_v2.send_sms(phonenumber=phone, geetest=gee)

    # Login with SMS code
    code = input("SMS code: ")
    cred = await login_v2.login_with_sms(
        phonenumber=phone,
        code=code,
        captcha_id=captcha_id
    )
    return cred
```

## Cookie Refresh

Refresh cookies before they expire. Requires `ac_time_value`:

```python
from bilibili_api import Credential, sync

credential = Credential(
    sessdata="...",
    bili_jct="...",
    ac_time_value="..."  # Required for refresh
)

# Check if refresh needed
needs_refresh = sync(credential.check_refresh())
print(f"Needs refresh: {needs_refresh}")

# Perform refresh
if needs_refresh:
    sync(credential.refresh())
    print("Cookies refreshed")
    print(credential.get_cookies())
```

**Notes:**
- Do not refresh too frequently
- If using credentials long-term, avoid logging into the same account in a browser (this invalidates cookies)
- After refresh, the new cookie values are updated in the `Credential` instance

## Security Best Practices

1. **Never hardcode credentials** in source code
2. **Use environment variables** for credential storage:

```python
import os
from bilibili_api import Credential

credential = Credential(
    sessdata=os.environ.get("BILI_SESSDATA"),
    bili_jct=os.environ.get("BILI_JCT"),
    buvid3=os.environ.get("BILI_BUVID3"),
)
```

3. **Use `.env` files** (add to `.gitignore`):

```python
# .env
BILI_SESSDATA=your_sessdata
BILI_JCT=your_bili_jct
BILI_BUVID3=your_buvid3
```

```python
# Load from .env
from dotenv import load_dotenv
load_dotenv()
```

4. **Rotate credentials** periodically
5. **Use minimal permissions** — only include fields needed for your use case
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 468kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 319kUpdated Claude CodeCodexVerifiedInstall