How do I install the Bilibili Subtitles skill?

Run npx skillmds@latest add hugohe3/bilibili-subtitles in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bilibili Subtitles safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bilibili Subtitles?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bilibili Subtitles free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bilibili Subtitles?

hugohe3 (@hugohe3) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bilibili Subtitles by hugohe3 — Agent Skill

Name: Bilibili Subtitles
Author: hugohe3

Bilibili Subtitles

获取哔哩哔哩（B站）单个视频、多个 BV 号或指定 UP 主空间的公开字幕轨道，转换为 SRT，并保存到 PPT Master 的 projects 目录。支持 Bilibili 官方二维码登录、 UP 主视频列表分页、并发下载、多 P 视频和无字幕清单。当用户要求“下载 B 站字幕” “提取 UP 主全部视频字幕”“批量导出 Bilibili AI 字幕”“把字幕保存到 projects”时使用。

hugohe3 Updated Sep 17, 2026

File contents

Bilibili 字幕下载

使用 scripts/download.py 调用 Bilibili 公开页面与播放器接口，下载已有字幕轨道。不要下载视频或用语音识别补造字幕。

快速开始

输出默认写入自动定位到的 PPT Master projects/：

# UP 主全部公开视频
python3 skills/bilibili-subtitles/scripts/download.py --mid 351608062 --zip

# 空间 URL
python3 skills/bilibili-subtitles/scripts/download.py \
  --space-url "https://space.bilibili.com/351608062"

# 一个或多个视频
python3 skills/bilibili-subtitles/scripts/download.py \
  --bvid BV16c3u6XEni BV1wo3M64EdV

# 已准备好的 JSON 视频清单
python3 skills/bilibili-subtitles/scripts/download.py \
  --video-list /path/to/videos.json

没有传入 --cookie-file 时，脚本生成 Bilibili 官方登录二维码并打印 QR_CODE: 路径。向用户展示该图片，等待用户在哔哩哔哩 App 确认；不要读取 Chrome Cookie、浏览器配置或会话存储。

如已有用户明确提供的 Netscape Cookie 文件，可传入：

python3 skills/bilibili-subtitles/scripts/download.py \
  --mid 351608062 \
  --cookie-file /path/to/cookies.txt

输出

默认项目目录：

projects/bilibili-subtitles-<mid-or-bvid>/
  subtitles/                 # SRT 文件，文件名包含序号与 BV 号
  no-subtitle-videos.csv     # 没有公开字幕轨道的视频
  failed-videos.csv          # 请求或解析失败的视频（仅失败时生成）
  <project-name>.zip         # 仅传入 --zip 时生成

脚本按以下顺序定位 PPT Master：--ppt-master-root、PPT_MASTER_ROOT 环境变量、当前工作目录、hugo-skills 的同级目录。无法定位时停止并要求显式指定，不要回退到 hugo-skills/projects/。

使用 --output 可以直接指定其它项目目录。字幕和清单属于本地项目材料；不要把登录 Cookie 写入项目或提交到 Git。

执行规则

优先使用 --mid 或 --space-url 自动分页获取该 UP 主的视频清单。
需要登录时使用脚本的官方二维码流程；二维码过期后重新运行。
使用默认并发数 8；遇到限流时降低 --concurrency，不要增加浏览器视频标签页。
保留 Bilibili 返回的时间轴和文字，不改写、不总结字幕正文。
完成后核对脚本汇总、SRT 文件数量和 failed-videos.csv；无字幕不算下载失败。
对已有项目重复运行时默认复用有效 SRT；只有用户明确要求刷新时传入 --overwrite。

依赖

pip install -r skills/bilibili-subtitles/resources/requirements.txt

除二维码图片生成外，其余功能只使用 Python 标准库。

---name: bilibili-subtitlesdescription: 获取哔哩哔哩（B站）单个视频、多个 BV 号或指定 UP 主空间的公开字幕轨道，转换为 SRT，并保存到 PPT Master 的 projects 目录。支持 Bilibili 官方二维码登录、 UP 主视频列表分页、并发下载、多 P 视频和无字幕清单。当用户要求“下载 B 站字幕” “提取 UP 主全部视频字幕”“批量导出 Bilibili AI 字幕”“把字幕保存到 projects”时使用。---# Bilibili 字幕下载使用 `scripts/download.py` 调用 Bilibili 公开页面与播放器接口，下载已有字幕轨道。不要下载视频或用语音识别补造字幕。## 快速开始输出默认写入自动定位到的 PPT Master `projects/`：```bash# UP 主全部公开视频python3 skills/bilibili-subtitles/scripts/download.py --mid 351608062 --zip# 空间 URLpython3 skills/bilibili-subtitles/scripts/download.py \ --space-url "https://space.bilibili.com/351608062"# 一个或多个视频python3 skills/bilibili-subtitles/scripts/download.py \ --bvid BV16c3u6XEni BV1wo3M64EdV# 已准备好的 JSON 视频清单python3 skills/bilibili-subtitles/scripts/download.py \ --video-list /path/to/videos.json```没有传入 `--cookie-file` 时，脚本生成 Bilibili 官方登录二维码并打印 `QR_CODE:` 路径。向用户展示该图片，等待用户在哔哩哔哩 App 确认；不要读取 Chrome Cookie、浏览器配置或会话存储。如已有用户明确提供的 Netscape Cookie 文件，可传入：```bashpython3 skills/bilibili-subtitles/scripts/download.py \ --mid 351608062 \ --cookie-file /path/to/cookies.txt```## 输出默认项目目录：```textprojects/bilibili-subtitles-<mid-or-bvid>/ subtitles/ # SRT 文件，文件名包含序号与 BV 号 no-subtitle-videos.csv # 没有公开字幕轨道的视频 failed-videos.csv # 请求或解析失败的视频（仅失败时生成） <project-name>.zip # 仅传入 --zip 时生成```脚本按以下顺序定位 PPT Master：`--ppt-master-root`、`PPT_MASTER_ROOT`环境变量、当前工作目录、`hugo-skills` 的同级目录。无法定位时停止并要求显式指定，不要回退到 `hugo-skills/projects/`。使用 `--output` 可以直接指定其它项目目录。字幕和清单属于本地项目材料；不要把登录 Cookie 写入项目或提交到 Git。## 执行规则1. 优先使用 `--mid` 或 `--space-url` 自动分页获取该 UP 主的视频清单。2. 需要登录时使用脚本的官方二维码流程；二维码过期后重新运行。3. 使用默认并发数 `8`；遇到限流时降低 `--concurrency`，不要增加浏览器视频标签页。4. 保留 Bilibili 返回的时间轴和文字，不改写、不总结字幕正文。5. 完成后核对脚本汇总、SRT 文件数量和 `failed-videos.csv`；无字幕不算下载失败。6. 对已有项目重复运行时默认复用有效 SRT；只有用户明确要求刷新时传入 `--overwrite`。## 依赖```bashpip install -r skills/bilibili-subtitles/resources/requirements.txt```除二维码图片生成外，其余功能只使用 Python 标准库。

Frequently asked questions