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/video-guide.md

View on GitHub
# Video Module Guide

## Video Class

```python
from bilibili_api import video, Credential

# By BV ID
v = video.Video(bvid="BV1uv411q7Mv")

# By AV ID
v = video.Video(aid=170001)

# With credentials (for actions)
cred = Credential(sessdata="...", bili_jct="...")
v = video.Video(bvid="BVxxxxxxxx", credential=cred)
```

## Information Methods

| Method | Description | Auth |
|--------|-------------|------|
| `get_info()` | Basic video info (title, stat, etc.) | No |
| `get_detail()` | Detailed info with related videos | No |
| `get_stat()` | View/like/coin/fav counts | No |
| `get_pages()` | Multi-part video pages | No |
| `get_online()` | Real-time viewer count | No |
| `get_tags()` | Video tags | No |
| `get_ai_conclusion()` | AI-generated summary | No |
| `get_subtitle()` | Subtitle data | No |
| `get_pbp()` | Playback progress data | No |

```python
async def get_video_info():
    v = video.Video(bvid="BV1uv411q7Mv")
    info = await v.get_info()
    print(f"Title: {info['title']}")
    print(f"Views: {info['stat']['view']}")
    print(f"Likes: {info['stat']['like']}")
```

## Action Methods (Require Credential)

| Method | Description |
|--------|-------------|
| `like(status)` | Like/unlike video |
| `pay_coin(num, like)` | Coin video (1-2 coins, like option) |
| `set_favorite(add_ids, del_ids)` | Add/remove from favorites |
| `triple()` | Like, coin, and favorite at once |
| `share()` | Record a share action |

```python
async def interact_with_video():
    cred = Credential(sessdata="...", bili_jct="...")
    v = video.Video(bvid="BVxxxxxxxx", credential=cred)

    # Like
    await v.like(True)

    # Coin + like
    await v.pay_coin(num=1, like=True)

    # Triple (like + coin + fav)
    await v.triple()

    # Add to favorites
    await v.set_favorite(add_ids=[123456])  # favorite_list ID
```

## Danmaku Methods

| Method | Description |
|--------|-------------|
| `get_danmakus(page_index)` | Get danmaku list |
| `get_danmaku_xml(page_index)` | Get raw XML danmaku |
| `get_special_dms(page_index)` | Get special danmaku |
| `send_danmaku(danmaku)` | Send danmaku (requires auth) |
| `get_history_danmaku_index(date)` | Get historical danmaku index |

```python
from bilibili_api import Danmaku, DmMode, DmFontSize

async def send_danmaku():
    cred = Credential(sessdata="...", bili_jct="...")
    v = video.Video(bvid="BVxxxxxxxx", credential=cred)

    dm = Danmaku(
        text="Hello!",
        dm_time=5.0,              # Video time (seconds)
        mode=DmMode.FLY,          # Scroll mode
        font_size=DmFontSize.NORMAL,
        color=0xFFFFFF,           # White
    )
    await v.send_danmaku(dm)

async def get_danmaku():
    v = video.Video(bvid="BV1AV411x7Gs")
    danmakus = await v.get_danmakus(page_index=0)
    for dm in danmakus:
        print(f"{dm.dm_time}s: {dm.text} (by {dm.crc32})")
```

## Video Download

### Complete Download Workflow

```python
import asyncio
import os
from bilibili_api import video, Credential, HEADERS, get_client

async def download_video(bvid: str, output: str = "video.mp4"):
    # Setup
    cred = Credential(sessdata="...", bili_jct="...", buvid3="...")
    v = video.Video(bvid=bvid, credential=cred)

    # Get download URLs
    download_data = await v.get_download_url(page_index=0)

    # Parse streams
    detecter = video.VideoDownloadURLDataDetecter(data=download_data)
    streams = detecter.detect_best_streams()

    # Check stream type
    if detecter.check_flv_mp4_stream():
        # FLV stream (single file with both video and audio)
        await download_file(streams[0].url, "temp.flv")
        os.system(f"ffmpeg -i temp.flv {output}")
        os.remove("temp.flv")
    else:
        # DASH streams (separate video and audio)
        await download_file(streams[0].url, "video_temp.m4s", "Video")
        await download_file(streams[1].url, "audio_temp.m4s", "Audio")

        # Merge with ffmpeg
        os.system(
            f"ffmpeg -i video_temp.m4s -i audio_temp.m4s "
            f"-vcodec copy -acodec copy {output}"
        )
        os.remove("video_temp.m4s")
        os.remove("audio_temp.m4s")

    print(f"Downloaded: {output}")

async def download_file(url: str, out: str, label: str = ""):
    client = get_client()
    dwn_id = await client.download_create(url, HEADERS)
    total = client.download_content_length(dwn_id)
    downloaded = 0

    with open(out, "wb") as f:
        while True:
            chunk = await client.download_chunk(dwn_id)
            if not chunk:
                break
            downloaded += f.write(chunk)
            print(f"{label} - {out} [{downloaded}/{total}]", end="\r")
    print()

asyncio.run(download_video("BV1AV411x7Gs"))
```

### Quality Enums

```python
from bilibili_api import video

# Video Quality
video.VideoQuality._4K_120FPS      # 125
video.VideoQuality._1080P_60FPS    # 116
video.VideoQuality._1080P_PLUS     # 112
video.VideoQuality._1080P          # 80
video.VideoQuality._720P_60FPS     # 74
video.VideoQuality._720P           # 64
video.VideoQuality._480P           # 32
video.VideoQuality._360P           # 16

# Audio Quality
video.AudioQuality._192K           # 30280
video.AudioQuality._132K           # 30232
video.AudioQuality._64K            # 30216

# Video Codecs
video.VideoCodecs.AVC              # HEPEC
video.VideoCodecs.HEV              # HEPEC
video.VideoCodecs.AV1              # HEPEC
```

## VideoOnlineMonitor (WebSocket)

Monitor real-time online count and danmaku:

```python
from bilibili_api import video
import asyncio

monitor = video.VideoOnlineMonitor(bvid="BV1AV411x7Gs")

@monitor.on('ONLINE')
async def on_online(event):
    print(f"Online: {event}")

@monitor.on('DANMAKU')
async def on_danmaku(event):
    print(f"Danmaku: {event}")

asyncio.run(monitor.connect())
```

## Module-Level Functions

```python
from bilibili_api import video

# Get video info by BV/AV without instantiating
info = await video.get_video_info(bvid="BVxxxxxxxx")

# AV/BV conversion
bvid = video.aid2bvid(170001)
aid = video.bvid2aid("BV17x411w7KC")
```

## Full API Reference

For complete method signatures and all available options, see:
`references/docs/modules/video.md`
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: 470kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall