bilibili-cli

bili

A command line for bilibili.com. bili resolves any video, user, comment, danmaku, dynamic, live room, bangumi, audio, article, or favorite folder into clean structured records. One pure-Go binary, no API key, no login.

Install • Commands • Usage • How it works

It talks to the public bilibili web endpoints over plain HTTPS: WBI signing, anonymous buvid session bootstrap, {code, message, data} envelope unwrapping, av/BV id conversion, and protobuf danmaku decoding are all handled for you. A cookie is optional — pass --cookie and bili reaches the same data your logged-in browser sees.

bili is an independent tool. It is not affiliated with bilibili.

Install

go install github.com/tamnd/bilibili-cli/cmd/bili@latest

Or grab a prebuilt binary from the releases, or run the container image:

docker run --rm ghcr.io/tamnd/bili:latest search 'lofi' -n 10

Shell completion is built in: bili completion bash|zsh|fish|powershell.

Commands

Full reference and guides live at bilibili-cli.tamnd.com.

Usage

bili video BV17x411w7KC                    # full video metadata
bili comments BV17x411w7KC -n 50           # top comments with replies
bili danmaku BV17x411w7KC                  # bullet-chat for the first part
bili search 'lofi' -n 20                   # search videos
bili user 122541                           # a creator's profile
bili bangumi ss12548                       # an anime season
bili rank --partition dance                # dance leaderboard

Records come out as a table (the default on a terminal), list, markdown, JSON, JSONL, CSV, TSV, url, or raw. The table uses rounded borders and a colored header on a true-color terminal; JSON and JSONL are syntax-highlighted too:

bili video BV17x411w7KC --fields bvid,title,view_count,like_count -o table
bili search 'lofi' -o jsonl | jq '{bvid, title, view_count}'
bili search 'lofi' -o url
bili user 122541 --videos -o jsonl
bili comments BV17x411w7KC --replies -o jsonl > comments.jsonl

Crawl a search result and pull comments and uploader profiles for each hit:

bili search 'lofi' -n 20 -o url \
  | bili crawl - --out ./data --comments --user

Global flags

-o, --output       list|table|markdown|json|jsonl|csv|tsv|url|raw   (auto: table on a TTY, jsonl when piped)
    --fields       comma-separated columns to keep, in order
    --no-header    omit the header row
    --template     Go text/template applied per record
-n, --limit        max records (0 = unlimited)
    --cookie       cookie header (SESSDATA=...; ...)
    --cookie-file  path to a Netscape cookie file
    --lang         locale for localized fields (default zh-CN)
-q, --quiet        suppress progress output
    --color        auto|always|never
    --rate         min spacing between requests (default 350ms)
    --timeout      per-request timeout (default 30s)
    --retries      retry attempts on 429/-412/5xx (default 4)
-j, --workers      concurrency for fan-out commands (default 4)
    --no-cache     bypass the on-disk cache
    --cache-ttl    cache freshness window (default 1h)
    --dry-run      print the requests that would be made
    --proxy        HTTP or SOCKS proxy URL

How it works

bilibili's public API is behind a few shared conventions. bili handles them so you do not have to:

WBI signing. Many endpoints reject unsigned requests. bili fetches the current WBI key pair from the nav endpoint, derives the mixin key, and signs each call with w_rid and wts.

Anonymous session. bili activates a fresh buvid3/buvid4 pair on first use so endpoints that expect a browser session answer normally.

The envelope. Responses arrive as {code, message, ttl, data} (or result for bangumi endpoints). bili unwraps it and maps bilibili's risk-control codes to readable errors.

IDs. Videos carry both an avNNN number and a BV string. bili converts between them, follows b23.tv short links, and classifies any id or URL you paste with bili id.

Danmaku. Bullet chat ships as a protobuf segment stream. bili decodes it into one record per comment with its timestamp, mode, color, and text.

Two importable packages ship alongside the CLI:

Exit codes

0  success
1  error
2  usage error
3  no results

Development

cmd/bili/    thin main entry point
cli/         cobra commands and output rendering
bili/        HTTP client, WBI signing, session bootstrap, id resolution, models
pkg/bvconv/  av/BV id conversion (no dependencies)
pkg/dmproto/ protobuf danmaku decoder (no dependencies)
docs/        documentation site (Hugo, tago-doks theme)

make build   # ./bili
make test    # go test ./...
make vet     # go vet ./...
make smoke   # build + live smoke script

Requires Go 1.23+.

Releasing

Push a version tag and GitHub Actions runs GoReleaser:

git tag -a v0.1.1 -m "v0.1.1"
git push --tags

The image tag carries no v prefix (ghcr.io/tamnd/bili:0.2.0).

License

Apache-2.0. See LICENSE.

bili is an independent client. Use it to access public data responsibly and within bilibili's terms of service.