bilibili-info-mcp

MCP server for fetching Bilibili video metadata and subtitles. Runs locally via stdio transport.

Features

• Fetch video metadata: title, author, view count, description, duration, publish date
• Fetch subtitles (requires login cookie): prioritizes Chinese, falls back to English
• WBI signature support for reliable subtitle retrieval
• Stdio transport for local MCP client integration

Usage

No installation required. Use directly with npx:

npx bilibili-info-mcp

MCP Client Configuration

Cursor / Claude Desktop

{
  "mcpServers": {
    "bilibili-info": {
      "command": "npx",
      "args": ["bilibili-info-mcp"],
      "env": {
        "SESSDATA": "your_bilibili_sessdata_cookie"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
SESSDATA	Only for subtitles	Bilibili login cookie. Find it in browser DevTools > Application > Cookies > bilibili.com after logging in.

Tool: get-bilibili-video-info

Fetches Bilibili video metadata and optionally subtitles.

Input

Parameter	Type	Required	Default	Description
url	string	Yes	-	Bilibili video URL, e.g. https://www.bilibili.com/video/BVxxxxx
includeSubtitles	boolean	No	false	Whether to fetch subtitles. Requires SESSDATA env var.

Supported URL formats:

• https://www.bilibili.com/video/BVxxxxx
• https://m.bilibili.com/video/BVxxxxx?k=v
• https://bilibili.com/video/BVxxxxx/

Output

{
  "title": "Video title",
  "author": "Author name",
  "viewCount": "12345",
  "description": "Video description",
  "lengthSeconds": "360",
  "publishDate": "2025-01-15T12:00:00+08:00",
  "subtitle": {
    "languageCode": "zh-Hans",
    "content": "Subtitle text content joined by spaces"
  }
}

Field	Type	Description
title	string	Video title
author	string	Uploader name
viewCount	string	Total view count
description	string	Video description (prefers desc_v2, falls back to desc)
lengthSeconds	string	Video duration in seconds
publishDate	string	Publish time in ISO 8601 format with +08:00 timezone
subtitle	object (optional)	Subtitle track, only present when includeSubtitles is true and subtitles are available

Subtitle Priority

When includeSubtitles is true, returns a single subtitle track with the following priority:

1. Chinese (matching 中文, zh-CN, zh-Hans, zh)
2. English (matching English, 英语, en, en-US)

Development

git clone https://github.com/sunwu51/bilibili-info-mcp.git
cd bilibili-info-mcp
npm install
npm run build

Project Structure

src/
  index.ts              # MCP server entry point (stdio transport)
  bilibili-fetcher.ts   # Bilibili API calls (video info + subtitles)
  wbi.ts                # WBI signature algorithm implementation

How It Works

1. Video info -- Calls https://api.bilibili.com/x/web-interface/view?bvid=BVID to get metadata.
2. WBI keys -- Fetches img_key and sub_key from https://api.bilibili.com/x/web-interface/nav (cached for 1 hour).
3. Subtitles -- Calls https://api.bilibili.com/x/player/wbi/v2 with WBI signature (w_rid + wts) and SESSDATA cookie to get subtitle URLs, then fetches the subtitle JSON content.

License

ISC