bilibili-mcp
bilibili-mcp
중국 최대 동영상 플랫폼인 **Bilibili (B站)**을 위한 콘텐츠 인텔리전스 브리지입니다. 검색, 트렌드, 동영상 정보, 자막 요약 - 핵심 티어는 계정이 필요 없습니다.
래핑 대상
Bilibili - 중국 동영상 공유 플랫폼입니다. 이 서버는 동영상을 재생하지 않습니다; 에이전트가 Bilibili 콘텐츠를 검색하고, 순위를 매기고, 요약할 수 있도록 메타데이터, 목록, 자막 대본을 반환합니다. docs/WRAPPEE.md를 참조하세요.
Related MCP server: Bilibili API MCP Server
미리보기

할 수 있는 작업
실행 방식
모드 | 호스트 앱 | 시기 |
Headless / API (기본값) | Bilibili 공개 웹 API | 모든 기능 - 계정 없음, GUI 없음 |
Bilibili는 로컬 앱이 아닌 웹 플랫폼입니다. 설치할 데스크톱 바이너리가 없습니다. 서버는 HTTPS를 통해 Bilibili 공개 API와 통신합니다.
입력 / 출력
방향 | 항목 | 비고 |
입력 | 검색 키워드, Bilibili URL (BV.../av...) |
|
출력 | 메타데이터 + 통계, 자막 대본 텍스트, 댓글 요약 |
|
기능
탐색 - 인기 피드, 전체 지역 순위, 인기 검색 키워드 (익명)
검색 - 동영상 및 크리에이터 (리스크 관리를 통과하려면 쿠키가 필요할 수 있음)
동영상 정보 - 메타데이터 + 통계, 파트 목록, 인기 댓글 (익명)
자막 대본 - 요약을 위한 자동 자막 텍스트 (킬러 기능)
계정 티어 (선택) - 팔로잉 피드, 즐겨찾기; +86 로그인 필요
기본적으로 익명 - 탐색, 동영상 정보, 자막 대본은 설정 없이 동작합니다. 계정 티어에만 중국 +86 로그인 쿠키가 필요합니다.
빠른 설치
요구 사항: uv (Python), Bun (webapp). 옵션 A (권장):
uv sync
uv run python -m bilibili_mcp.server --mode http --port 11185또는 start.bat / start.ps1로 전체 스택(백엔드 + 웹앱 + 브라우저)을 실행하세요. 백엔드 11185, 프론트엔드 11186.
처음이신가요? 실제 호스트 호출을 기대하기 전에 docs/ONBOARDING.md를 완료하세요 (익명 티어는 아무것도 필요 없음; 계정 티어는 +86 로그인 필요).
문서
문서 | 다루는 내용 |
계정, +86 번호 문제, 첫 실행 설정 | |
환경 변수, 티어, LLM 제공자 | |
전체 MCP + REST 참조 | |
구조, 실행, 테스트 | |
증상 -> 해결 | |
Bilibili 플랫폼 정보 | |
기능 명세 + 단계 계획 |
티어 상태
티어 | 필요 조건 | 잠금 해제 |
익명 | 없음 | 탐색, 검색, 동영상 정보, 자막 대본 |
계정 |
| 팔로잉 피드, 즐겨찾기 |
라이선스
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.
Maintenance
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.194MIT
- 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