Bilibili Subtitle Fetch
一个用于获取 Bilibili 视频字幕的 MCP Server，支持语言和输出格式选项。
uv tool install --python 3.13 bilibili-subtitle-fetch
支持以下输入：
BV号，例如BV1fz4y1j7Mf- 标准视频链接，例如
https://www.bilibili.com/video/BV1fz4y1j7Mf?p=2 - 短链，例如
https://b23.tv/FAm7Xn4
配置
凭据配置文件
首次使用时执行 bilibili-subtitle-fetch init，然后粘贴你的 Bilibili Cookie。
默认配置文件路径：
- Windows:
%APPDATA%\bilibili-subtitle-fetch\config.toml - Linux/macOS:
~/.config/bilibili-subtitle-fetch/config.toml
也可以通过 --config /path/to/config.toml 指定自定义路径。
配置文件会在 [credential] 下保存这些字段：
sessdata- 访问需要登录态的字幕接口时必需bili_jct- 自动刷新时必需ac_time_value- 自动刷新时必需buvid3、buvid4、dedeuserid- 可选，但建议一并保存
当 sessdata、bili_jct 和 ac_time_value 都存在时，服务会在发起需要登录态的请求前自动检查是否需要刷新 Cookie，并将新值回写到 config.toml，不需要手动执行刷新命令。
ASR 配置 (可选)
配置文件同样支持 [asr] 段落配置默认的音频转写行为：
enable_asr- 是否开启 ASR 回退 (true/false)。开启后，如果视频未提供自带字幕，程序会自动下载音频并生成字幕。model_size- Whisper 模型大小，默认为base。也可以选用tiny、small等。
运行参数
--preferred-lang- 覆盖默认字幕语言--output-format- 覆盖默认输出格式--config- 使用自定义配置文件路径
CLI 用法
先执行 bilibili-subtitle-fetch init 配置 Cookie，然后可以直接在终端获取字幕：
bilibili-subtitle-fetch fetch BV1fz4y1j7Mf
bilibili-subtitle-fetch fetch "https://www.bilibili.com/video/BV1fz4y1j7Mf?p=2"
命令会把字幕输出到标准输出，并在成功后自动复制到剪贴板。
可选参数：
--preferred-lang- 指定优先字幕语言--output-format text|timestamped- 指定输出格式--no-clipboard- 只输出，不复制到剪贴板--asr- 强制启用 ASR 语音识别回退--no-asr- 强制关闭 ASR 语音识别回退
1 maintainer
Metadata
1 maintainer
Release files for bilibili-subtitle-fetch 0.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| bilibili_subtitle_fetch-0.3.2.tar.gz | 146.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bilibili_subtitle_fetch-0.3.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 173.0 kB
Release files / bilibili_subtitle_fetch-0.3.2.tar.gz
| Download URL | bilibili_subtitle_fetch-0.3.2.tar.gz |
|---|---|
| Size | 146.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5742eb6dbbd5f52f5f5b4ffdad26c09ac99c379192cf205f585285c06cc07298
|
|
BLAKE2b-256 checksum How to use checksums |
fde231d6d40abeae58cca2a0c52b28ad15a40cfab0bbd86ff00b88ca4396e641
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / bilibili_subtitle_fetch-0.3.2-py3-none-any.whl
| Download URL | bilibili_subtitle_fetch-0.3.2-py3-none-any.whl |
|---|---|
| Size | 26.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bd932237e4405d3a05fcd0d9ca853c74eb472dd0a5ee1ab88a5bce6e23a6cea3
|
|
BLAKE2b-256 checksum How to use checksums |
defae27b65889e8376e525448fdb445f1a67e4c47b6b6a92b8f8e13bd8b724b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for bilibili-subtitle-fetch 0.3.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
