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/configuration.md

View on GitHub
# Configuration

## Request Settings

```python
from bilibili_api import request_settings
```

### Available Settings

| Setting | Type | Default | curl_cffi | aiohttp | httpx | Description |
|---------|------|---------|-----------|---------|-------|-------------|
| `proxy` | str | `""` | ✅ | ✅ | ✅ | HTTP/HTTPS proxy URL |
| `timeout` | float | `30.0` | ✅ | ✅ | ✅ | Request timeout in seconds |
| `verify_ssl` | bool | `True` | ✅ | ✅ | ✅ | Verify SSL certificates |
| `trust_env` | bool | `True` | ✅ | ✅ | ✅ | Use environment proxy settings |
| `impersonate` | str | `""` | ✅ | ❌ | ❌ | Browser fingerprint to mimic |
| `http2` | bool | `False` | ✅ | ❌ | ✅ | Enable HTTP/2 |
| `wbi_retry_times` | int | `3` | \\ | \\ | \\ | WBI signature retry limit |
| `enable_auto_buvid` | bool | `True` | \\ | \\ | \\ | Auto-generate buvid |
| `enable_bili_ticket` | bool | `False` | \\ | \\ | \\ | Auto-generate bili_ticket |

### Setting Methods

```python
# Set individual settings
request_settings.set_proxy("http://127.0.0.1:7890")
request_settings.set_timeout(60.0)
request_settings.set_verify_ssl(False)
request_settings.set_trust_env(True)

# Generic setter
request_settings.set("impersonate", "chrome131")

# Get settings
proxy = request_settings.get_proxy()
timeout = request_settings.get("timeout")
all_settings = request_settings.get_all()
```

## Proxy Configuration

Two methods to configure proxy:

### Method 1: Global Proxy

```python
request_settings.set_proxy("http://127.0.0.1:7890")

# With authentication
request_settings.set_proxy("http://user:pass@proxy.example.com:8080")
```

### Method 2: Per-Credential Proxy

```python
from bilibili_api import Credential

credential = Credential(
    sessdata="...",
    bili_jct="...",
    proxy="http://127.0.0.1:7890"
)
```

## HTTP Client Selection

Three HTTP backends available:

| Client | Priority | Request | Stream | WebSocket | Notes |
|--------|----------|---------|--------|-----------|-------|
| `curl_cffi` | 3 (highest) | ✅ | ✅ | ✅ | Supports TLS/JA3 impersonation |
| `aiohttp` | 2 | ✅ | ✅ | ✅ | Pure Python, most compatible |
| `httpx` | 1 (lowest) | ✅ | ✅ | ❌ | No WebSocket support |

### Switch Client

```python
from bilibili_api import select_client, get_selected_client

select_client("curl_cffi")
print(get_selected_client())  # "curl_cffi"
```

### Access Session

```python
from bilibili_api import get_session, set_session

# Get the underlying session
session = get_session()  # e.g., httpx.AsyncClient

# Use custom session
import httpx
custom_session = httpx.AsyncClient(timeout=120.0)
set_session(custom_session)
```

### Browser Impersonation (curl_cffi)

```python
select_client("curl_cffi")
request_settings.set("impersonate", "chrome131")
# Available: chrome99, chrome100, chrome101, ..., edge99, safari15_3, etc.
```

## Request Logging

```python
from bilibili_api import request_log

# Enable logging
request_log.set_on(True)

# Filter by event types
request_log.set_on_events(["API_REQUEST", "API_RESPONSE"])

# Ignore certain events
request_log.set_ignore_events(["WS_RECV"])
```

### Event Types

- `API_REQUEST` — API call initiated
- `API_RESPONSE` — API response received
- `ANTI_SPIDER` — Anti-spider measures triggered
- `WS_CONNECT` — WebSocket connected
- `WS_RECV` — WebSocket message received
- `WS_SEND` — WebSocket message sent
- `WS_CLOSE` — WebSocket closed

## Anti-Spider Measures

### WBI Signature

Bilibili uses WBI signatures to protect certain APIs. The library handles this automatically.

```python
from bilibili_api import recalculate_wbi

# Manual WBI key refresh (usually not needed)
await recalculate_wbi()

# Set retry limit
request_settings.set_wbi_retry_times(10)  # default: 3
```

### BUVID Auto-Generation

```python
from bilibili_api import refresh_buvid

# Enable/disable auto-generation
request_settings.set_enable_auto_buvid(True)  # default: True

# Manual refresh
await refresh_buvid()
```

### Bili Ticket

```python
from bilibili_api import refresh_bili_ticket

# Enable bili_ticket
request_settings.set_enable_bili_ticket(True)  # default: False

# Manual refresh
await refresh_bili_ticket()
```

## Custom Client

Extend `BiliAPIClient` to use a custom HTTP backend:

```python
from bilibili_api import BiliAPIClient, register_client

class MyClient(BiliAPIClient):
    def __init__(self, proxy="", timeout=0.0, verify_ssl=True, trust_env=True, session=None):
        super().__init__(proxy, timeout, verify_ssl, trust_env, session)
        # Custom initialization

    async def request(self, method, url, params={}, data={}, files={}, headers={}, cookies={}, allow_redirects=True):
        # Implement request logic
        pass

    # Implement other required methods...

register_client("my_client", MyClient, {"custom_setting": "default_value"})
```

See `<project_root>/bilibili_api/clients/` for reference implementations.
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: 469kUpdated Claude CodeCodexVerifiedInstall
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: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated 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: 321kUpdated Claude CodeCodexVerifiedInstall