bilibili-cli

Name: bilibili-cli
Author: public-clis

github.com/public-clisOther1.1k753 installsUpdated 33w ago

About bilibili-cli

bilibili-cli is a command-line tool for agents to query Bilibili videos, search content, browse user profiles, and interact with videos. It supports structured YAML and JSON output, and recommends subtitles as the primary source for video analysis.

Key features

01Fetch video details and subtitles
02Search videos and users
03Browse trending, rankings, and feeds
04View profiles and user videos
05Like, coin, and favorite videos
06Export YAML or JSON

Use cases

01Find videos on a specific topic
02Read subtitles to summarize a video
03Research a creator and recent uploads
04Manage favorites, watch-later, and history

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/public-clis/bilibili-cli --skill bilibili-cli

After installing, type/bilibili-cliin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

LICENSE

README.md

CHANGELOG.md

.gitignore

SCHEMA.md

pyproject.toml

.github/ISSUE_TEMPLATE/

feature_request.yml

bug_report.yml

.github/workflows/

publish.yml

ci.yml

bili_cli/

__init__.py

auth.py

cli.py

client.py

payloads.py

formatter.py

exceptions.py

bili_cli/commands/

__init__.py

collections.py

common.py

audio.py

account.py

interactions.py

discovery.py

user_search.py

video.py

tests/

conftest.py

test_audio.py

test_cli.py

test_auth.py

Details

From the project README

bilibili-cli Skill

A CLI tool for interacting with Bilibili (哔哩哔哩). Use it to fetch video info, search content, browse user profiles, and perform interactions like liking or triple-clicking.

Agent Defaults

When you need machine-readable output:

Prefer --yaml first because it is usually more token-efficient than pretty JSON.
Use --json only when downstream tooling strictly requires JSON.
Keep result sets small with --max, --page, or --offset.
Prefer specific commands over broad ones. Example: use bili user-videos 946974 --max 3 --yaml instead of fetching large timelines.
When summarizing a video, fetch subtitles first. Subtitles usually contain the video's core content and are the best primary source for summaries.
Only fall back to --ai, comments, or audio extraction when subtitles are unavailable or clearly insufficient.

Prerequisites

# Install (requires Python 3.10+)
uv tool install bilibili-cli
# Or: pipx install bilibili-cli

# If you need audio extraction support (requires PyAV)
uv tool install "bilibili-cli[audio]"
# Or: pipx install "bilibili-cli[audio]"

# Upgrade to latest (recommended to avoid API errors)
uv tool upgrade bilibili-cli
# Or: pipx upgrade bilibili-cli

Authentication

Most read commands work without login. Subtitles, favorites/following/watch-later/history, feed, and interactions require login.

bili status                    # Check if logged in (exit 0 = yes, 1 = no)
bili login                     # QR code login (if not authenticated)

Authentication auto-detects local browser cookies (Chrome/Firefox/Edge/Brave). If cookies are found and valid, no manual login needed. Credentials are saved to ~/.bilibili-cli/credential.json.

Command Reference

Video

# Get video details (accepts BV ID or full URL)
bili video BV1ABcsztEcY
bili video https://www.bilibili.com/video/BV1ABcsztEcY

# Options
bili video BV1ABcsztEcY --subtitle            # Show subtitles (plain text)
bili video BV1ABcsztEcY --subtitle-timeline   # Show subtitles with timestamps
bili video BV1ABcsztEcY -st --subtitle-format srt  # Export as SRT format
bili video BV1ABcsztEcY --ai            # Show B站 AI summary
bili video BV1ABcsztEcY --comments      # Show top comments
bili video BV1ABcsztEcY --related       # Show related videos
bili video BV1ABcsztEcY --yaml          # Token-efficient YAML output
bili video BV1ABcsztEcY --json          # Structured JSON envelope

User

# Look up user profile (by UID or username)
bili user 946974
bili user "影视飓风"

# List user's videos
bili user-videos 946974 --max 20
bili user-videos "影视飓风" --yaml

Search

# Search users (default)
bili search "关键词"

# Search videos
bili search "关键词" --type video

# Pagination and limit
bili search "关键词" --type video --max 5
bili search "关键词" --page 2

Discovery

bili hot                       # Trending/popular videos
bili hot --page 2 --max 10     # Page 2, limit 10
bili rank                      # Site-wide ranking (3-day)
bili rank --day 7 --max 30     # 7-day ranking, top 30
bili feed                      # Dynamic timeline (requires login)
bili feed --offset 1234567890  # Next page via returned cursor
bili my-dynamics               # My posted dynamics (requires login)
bili dynamic-post "hello"      # Publish text dynamic (requires write credential)
bili dynamic-delete 123456789  # Delete one dynamic (requires write credential)

Collections (require login)

bili favorites                 # List favorite folders
bili favorites <ID> --page 2   # Videos in a folder
bili following                 # Following list
bili watch-later               # Watch later list
bili history                   # Watch history

Audio Extraction

Requires bilibili-cli[audio] extra (PyAV). Install with uv tool install "bilibili-cli[audio]".

# Download audio and split into ASR-ready WAV segments (25s each, 16kHz mono)
bili audio BV1ABcsztEcY                 # Split to /tmp/bilibili-cli/{title}/
bili audio BV1ABcsztEcY --segment 60    # 60s per segment
bili audio BV1ABcsztEcY --no-split      # Full m4a file, no splitting
bili audio BV1ABcsztEcY -o ~/data/      # Custom output directory

Interactions (require login)

bili like BV1ABcsztEcY         # Like a video
bili like BV1ABcsztEcY --undo  # Unlike
bili coin BV1ABcsztEcY         # Give 1 coin
bili coin BV1ABcsztEcY -n 2    # Give 2 coins
bili triple BV1ABcsztEcY       # 一键三连 (like + coin + favorite)
bili unfollow 946974           # Unfollow by UID

Account

bili status                    # Quick login check
bili status --yaml             # Structured auth status
bili whoami                    # Detailed profile info
bili whoami --yaml              # Profile as YAML
bili whoami --json              # Profile as JSON
bili login                     # QR code login
bili logout                    # Clear credentials

Structured Output

Major query commands support both --yaml and --json for machine-readable output. Prefer YAML for agent use:

bili status --yaml                                # Quick structured auth check
bili video BV1ABcsztEcY --yaml                       # Preferred for AI agents
bili hot --max 5 --yaml                             # Smaller, token-efficient payload
bili user 946974 --json | jq -r '.data.user.name'   # JSON when jq is needed

When stdout is not a TTY, bilibili-cli defaults to YAML automatically. Use OUTPUT=yaml|json|rich|auto to override the default output mode. All machine-readable output uses the envelope documented in SCHEMA.md.

Debugging

bili -v <command>              # Enable verbose/debug logging for any command

Common Patterns for AI Agents

# For video summarization, fetch subtitles first
bili video BV1ABcsztEcY --subtitle

# Only use AI summary as a fallback or secondary signal
bili video BV1ABcsztEcY --ai

# Get comments for sentiment analysis
bili video BV1ABcsztEcY --comments

# Extract audio for speech-to-text (ASR)
# Segments are saved to /tmp/bilibili-cli/{title}/seg_000.wav, seg_001.wav, ...
bili audio BV1ABcsztEcY --segment 25

# Find a user's latest video BV ID with minimal payload
bili user-videos 946974 --max 1 --yaml

# Check if logged in before performing actions
bili status && bili like BV1ABcsztEcY

# Search and inspect the first few results
bili search "topic" --type video --max 3 --yaml

Workflow: Video Content Analysis

# 1. Search for a topic
bili search "AI" --type video --max 5

# 2. Get subtitles first for summarization
bili video BV1xxx --subtitle

# 3. If subtitles are missing or incomplete, try AI summary
bili video BV1xxx --ai

# 4. If there is still not enough content, extract audio for ASR
bili audio BV1xxx --segment 25

# 5. Get comments for audience reaction
bili video BV1xxx --comments

Workflow: UP主 Research

# 1. Look up UP主 profile
bili user "影视飓风"

# 2. Get their recent videos
bili user-videos 946974 --max 10

# 3. Inspect a specific video
bili video BV1xxx --ai --comments

Error Handling

Commands exit with code 0 on success, non-zero on failure
Error messages are prefixed with ❌
Login-required commands show ⚠️ with instruction to run bili login
Invalid BV IDs show a clear error message

Safety Notes

Do not ask users to share raw credential/cookie values in chat logs.
Prefer local browser cookie extraction over manual secret copy/paste.
If auth fails, ask the user to re-login via bili login.

Comments

Markdown supported

Details

Author: public-clis
Repository: public-clis/bilibili-cli
Category: Other
Installs: 753
GitHub stars: 1,130

Report

More skills

All skills

soultrace

github.com/soultrace-ai

345.6k

Take a personality assessment via the SoulTrace API. Use when the user wants to take a personality test, discover their psychological archetype, understand their personality traits, or get a color-based personality profile. The API uses a 5-color psychological model (White=structure, Blue=understanding, Black=agency, Red=intensity, Green=connection) with Bayesian adaptive question selection to classify users into one of 25 archetypes. Triggers on: personality test, personality assessment, what's my personality, take a quiz, archetype test, color personality, soultrace.

deepline-feedback

code.deepline.com

36.4k

Retired. Reporting feedback and sharing a session are documented by the CLI itself: run `deepline feedback send --help` and `deepline sessions send --help`. Kept only so installed CLIs that still list this skill keep syncing

value

github.com/hugmouse

35.5k

This skill does absolutely nothing, as well as the agent that uses it

dbs-diagnosis

github.com/dontbesilent2025

29.8k

Automatically identifies whether the user is solving a specific business problem or seeking a comprehensive business model review, then starts the corresponding diagnostic process. Use when the user wants to break down a business, review a business model, or resolve a specific business challenge.