Bilibili Subtitle Fetch

@Initsnow

About Bilibili Subtitle Fetch

MCP server for fetching Bilibili video subtitles with language and format options.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bilibili-subtitle-fetch": {
      "command": "uvx",
      "args": [
        "bilibili-subtitle-fetch"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Bilibili Subtitle Fetch?

Bilibili Subtitle Fetch is an MCP server that retrieves subtitles from Bilibili videos. It supports multiple input formats (BV numbers, full video URLs, and short links), language selection, and output formatting. It is intended for developers and users who need programmatic access to Bilibili subtitles.

How to use Bilibili Subtitle Fetch?

Install the server with uv tool install --python 3.13 bilibili-subtitle-fetch. Run bilibili-subtitle-fetch init to configure your Bilibili cookie, then fetch subtitles with bilibili-subtitle-fetch fetch <BV or URL>. The fetched subtitle is printed to stdout and automatically copied to the clipboard.

Key features of Bilibili Subtitle Fetch

Accepts BV numbers, full video links, and short URLs.
Configurable preferred subtitle language.
Output formats: plain text or timestamped.
Automatic ASR (Whisper) fallback when no subtitle exists.
Automatic cookie refresh when credentials are provided.
Copied to clipboard after fetching.

Use cases of Bilibili Subtitle Fetch

Extract subtitles for language learning or translation.
Save subtitles for offline reading or analysis.
Integrate subtitle retrieval into AI or automation workflows.
Compare timestamped subtitles with video content.

FAQ from Bilibili Subtitle Fetch

How do I configure Bilibili credentials?

Run bilibili-subtitle-fetch init and paste your Bilibili cookie. The configuration is saved to ~/.config/bilibili-subtitle-fetch/config.toml (Linux/macOS) or %APPDATA%\bilibili-subtitle-fetch\config.toml (Windows).

What is the ASR fallback feature?

If a video has no built-in subtitles, the server can automatically download the audio and generate subtitles using OpenAI Whisper. This is enabled or disabled via the [asr] config section or the --asr/--no-asr flags.

What output formats are available?

Two formats: text (plain subtitle text) and timestamped (subtitle content with timestamps). The default can be overridden with --output-format.

Can I use a custom configuration file path?

Yes, use the --config /path/to/config.toml argument when running the server or CLI commands.

What dependencies does the server require?

Python 3.13, the uv tool, and optionally Whisper for ASR fallback. A valid Bilibili cookie is required for subtitle access.

Frequently asked questions

How do I configure Bilibili credentials?

Run `bilibili-subtitle-fetch init` and paste your Bilibili cookie. The configuration is saved to `~/.config/bilibili-subtitle-fetch/config.toml` (Linux/macOS) or `%APPDATA%\bilibili-subtitle-fetch\config.toml` (Windows).

What is the ASR fallback feature?

If a video has no built-in subtitles, the server can automatically download the audio and generate subtitles using OpenAI Whisper. This is enabled or disabled via the `[asr]` config section or the `--asr`/`--no-asr` flags.

What output formats are available?

Two formats: `text` (plain subtitle text) and `timestamped` (subtitle content with timestamps). The default can be overridden with `--output-format`.

Can I use a custom configuration file path?

Yes, use the `--config /path/to/config.toml` argument when running the server or CLI commands.

What dependencies does the server require?

Python 3.13, the `uv` tool, and optionally Whisper for ASR fallback. A valid Bilibili cookie is required for subtitle access.

Comments

Basic information

More Browser Automation MCP servers

Puppeteer Vision Mcp Server

djannot

App Store Scraper MCP Server

appreply-co

This is an MCP server that provides tools to LLMs for searching and analyzing apps from both Google Play Store and Apple App Store – perfect for ASO.

Puppeteer

modelcontextprotocol

Model Context Protocol Servers

88.1K

Webpage Screenshot MCP Server

ananddtyagi

An MCP that gives your agent the ability to snap a screenshot of webpages. Useful when you want your agent to check its progress during development.

Umut Naci

firecrawl

The API to search, scrape, and interact with the web at scale. 🔥

148.0K