bilibili-mcp
Provides tools for searching Bilibili videos and creators, retrieving video metadata and stats, exploring trending and popular feeds, fetching hot search keywords, and obtaining auto-subtitle transcripts for summarisation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bilibili-mcp what are the top trending videos on Bilibili right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bilibili-mcp
A content-intelligence bridge for Bilibili (B站), China's largest video platform. Search, trending, video intel and transcript summarisation - no account needed for the core tier.
What this wraps
Bilibili - the Chinese video sharing platform. This server does not play video; it returns metadata, lists and subtitle transcripts so an agent can search, rank and summarise Bilibili content. See docs/WRAPPEE.md.
Related MCP server: Bilibili API MCP Server
Preview

What You Can Do
How it runs
Mode | Host app | When |
Headless / API (default) | Bilibili public web APIs | Everything - no account, no GUI |
Bilibili is a web platform, not a local app - there is no desktop binary to install. The server talks to Bilibili's public API over HTTPS.
Hands-in / Hands-out
Direction | Artifacts | Notes |
Hands-in | search keyword, Bilibili URL (BV.../av...) |
|
Hands-out | metadata + stats, transcript text, comment summaries |
|
Capabilities
Explore - popular feed, all-region ranking, hot search keywords (anonymous)
Search - videos and creators (may need a cookie to pass risk control)
Video intel - metadata + stats, part list, hot comments (anonymous)
Transcript - auto-subtitle text for summarisation (the killer feature)
Account tier (optional) - following feed, favorites; needs a +86 login
Anonymous by default - explore, video intel and transcripts work with zero setup. Only the account tier needs a Chinese +86 login cookie.
Quick Install
Requirements: uv (Python), Bun (webapp). Option A (recommended):
uv sync
uv run python -m bilibili_mcp.server --mode http --port 11185Or run the full stack (backend + webapp + browser) with start.bat /
start.ps1. Backend 11185, frontend 11186.
First time? Complete docs/ONBOARDING.md before expecting live host calls (anonymous tier needs nothing; account tier needs a +86 login).
Documentation
Doc | What it covers |
Accounts, the +86 number question, first-run setup | |
Env vars, tiers, LLM provider | |
Full MCP + REST reference | |
Layout, running, testing | |
Symptom -> fix | |
About the Bilibili platform | |
Feature spec + stage plan |
Tier status
Tier | Requires | Unlocks |
Anonymous | nothing | explore, search, video intel, transcript |
Account |
| following feed, favorites |
License
MIT
Available Tools
10 toolsbilibili_accountA
Account-tier operations: tier status, following feed, favorites.
[RATIONALE] The account tier is one logical surface (your logged-in Bilibili world) with several sub-surfaces; one tool with an operation discriminator keeps it compact while the auth-gated ops are honestly marked requires_login.
Return Format
{"success": bool, "operation": str, "data": {...}, "message": str}
Examples
bilibili_account(operation="status") bilibili_account(operation="following") bilibili_account(operation="favorites")
Inputs: operation (required), mid. Returns: data, error, message, success, +3 more
bilibili_exploreA
Discover what is trending on Bilibili: popular feed, rankings, hot keywords.
[RATIONALE] Discovery has three list surfaces (popular, rank, hot search) that share a single 'video-ish list' output; one tool with an operation discriminator keeps the surface compact and discoverable.
Return Format
{"success": bool, "operation": str, "data": [...], "count": int}
Examples
bilibili_explore(operation="trending", limit=10) bilibili_explore(operation="rank", rid=3, limit=15) bilibili_explore(operation="hot_search", limit=10)
Inputs: operation (required), rid, limit. Returns: data, count, error, message, +4 more
bilibili_helpA
Explain how to use the bilibili-mcp server.
Return Format
{"success": bool, "data": {"help": str, "tools": [...]}, "message": str}
Examples
bilibili_help() bilibili_help(topic="transcript")
Inputs: topic. Returns: object
bilibili_searchA
Search Bilibili for videos or creators.
Return Format
{"success": bool, "operation": str, "data": [...], "count": int}
Examples
bilibili_search(operation="video", keyword="微积分") bilibili_search(operation="user", keyword="罗翔", limit=5)
Inputs: keyword (required), operation (required), limit. Returns: data, count, error, message, +4 more
bilibili_shutdownA
Gracefully stop the bilibili-mcp server.
Return Format
{"success": bool, "message": str}
Examples
bilibili_shutdown(confirm=True)
Inputs: confirm. Returns: object
bilibili_transcriptA
Fetch a video's auto-generated subtitle track as plain text.
Returns the transcript as text so an LLM can summarise or translate it. Some videos have no subtitles (or subtitles require login to access); in that case the tool returns an honest, actionable error rather than empty.
Return Format
{"success": bool, "data": {"bvid": str, "cid": int, "lang": str, "text": str, "word_count": int}, "message": str}
Examples
bilibili_transcript(bvid="BV1xx411c7mD") bilibili_transcript(bvid="https://www.bilibili.com/video/BV1xx411c7mD", part_index=2)
Inputs: bvid (required), part_index. Returns: data, error, message, success, +2 more
bilibili_videoA
Inspect a single Bilibili video: metadata, comments, or part list.
Return Format
{"success": bool, "operation": str, "data": {...}, "message": str}
Examples
bilibili_video(operation="info", bvid="BV1xx411c7mD") bilibili_video(operation="comments", bvid="BV1xx411c7mD", limit=10) bilibili_video(operation="pages", bvid="BV1xx411c7mD")
Inputs: operation (required), aid, bvid, limit. Returns: data, error, message, success, +3 more
show_bilibili_cache_cardB
Show and clear the Bilibili response cache.
[RATIONALE] A tiny status surface for the TTL cache - helps debug rate-limit staleness.
Return Format
ToolResult with content + structured PrefabApp card.
Examples
show_bilibili_cache_card()
Inputs: no named parameters.
show_bilibili_status_cardA
Show bilibili-mcp configuration status as a rich in-chat card.
[RATIONALE] Status tools MUST ship a Prefab surface - one call shows tier, cookie state and cache headroom at a glance.
Return Format
ToolResult with content (plain text fallback) + structured PrefabApp card.
Examples
show_bilibili_status_card()
Inputs: no named parameters.
show_bilibili_trending_cardA
Show what is trending on Bilibili right now as a rich in-chat card.
[RATIONALE] Status/list tools MUST ship a Prefab surface per fleet SOTA - this card renders the popular feed in chat without the agent reading raw JSON.
Return Format
ToolResult with content (plain text fallback) + structured PrefabApp card.
Examples
show_bilibili_trending_card(limit=5)
Inputs: limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Core tools cleanly separate account, explore, search, transcript, and video resources. Minor overlap exists between bilibili_explore(trending) and show_bilibili_trending_card, and bilibili_account(operation='status') could be confused with show_bilibili_status_card, but the descriptions make the distinction recoverable.
All tools use a bilibili_ prefix or show_bilibili_*_card pattern, so the two naming families are internally consistent. The mix of noun-style names like bilibili_account and verb-style names like bilibili_search is a minor deviation but still predictable and readable.
Ten tools is well-scoped for a Bilibili-oriented server covering discovery, search, video inspection, transcripts, account data, and system status. The card tools add some redundancy but each has a distinct presentation purpose.
The read/inspect/search/transcribe workflow is well covered: videos, comments, pages, transcript, search, trending, rankings, hot search, account following, and favorites. Minor gaps include no user profile detail, no comment thread replies, and no authenticated actions beyond reading.
Related MCP Connectors
Bilibili videos for AI agents: search, creators, trending, stats, tags and danmaku comments.
Bilibili (B站) data without login: video stats, comments, danmaku, creators, trending, hot searches.
Bilibili public video, article, dynamic, creator, comments, reactions, and transcript tools.
Chinese social trends — Weibo, Douyin, Xiaohongshu, Bilibili, Zhihu — as agent tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Bilibili (B站) platform through API and web scraping. Supports video search, article search, video info retrieval, comment fetching, danmaku extraction, and article content access.4-
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Bilibili (哔哩哔哩) through its API, supporting video search and recommendations, user search, dynamic feeds, video collections, and danmaku retrieval through natural language.5-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to directly operate Bilibili, providing 27 tools for login, search, content publishing, data analysis, and interaction.197MIT
- AlicenseNot gradedqualityCmaintenanceEnables models to look up Bilibili's trending videos, keyword search results, video details, and popular danmaku, returning compact plain-text summaries instead of bulky JSON. Works without login, cookies, or extra dependencies, and also runs standalone from the command line.MIT