Bilibili Subtitle Fetch について
Bilibili 動画の字幕を取得するコマンドラインツール兼 MCP サーバーです。動画 ID やリンクを受け付け、言語と出力形式を選べます。字幕がない場合は ASR も利用できます。
主な機能
- 01ID またはリンクで字幕を取得
- 02字幕の言語を選択
- 03テキストまたはタイムスタンプ付きで出力
- 04任意で ASR によるフォールバック
- 05結果をクリップボードにコピー
活用シーン
- 01Bilibili 動画の字幕を取得
- 02指定した言語の字幕を取得
- 03動画に字幕がない場合に字幕を生成
MCP 対応
Bilibili 字幕を取得する MCP サーバーとして紹介されています。README には MCP クライアントに公開する具体的なツールは記載されていません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
プロジェクトの README より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 语音识别回退
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。