$npx -y skills add jackspace/ClaudeSkillz --skill bilibili-subtitle-fetcher-skill_suyuan2022从哔哩哔哩(B站)搜索视频、获取字幕并转换为 Markdown 格式。当用户需要搜索 B 站视频、下载视频字幕、批量获取字幕、分析视频内容时使用。支持关键词搜索、单视频处理、批量并发下载。
| 1 | # 哔哩哔哩字幕获取器 |
| 2 | |
| 3 | 从 B 站搜索视频、批量下载字幕并转换为 Markdown 格式的专业工具。 |
| 4 | |
| 5 | ## 核心功能 |
| 6 | |
| 7 | 1. **关键词搜索** - 搜索 B 站视频并获取详细信息 |
| 8 | 2. **字幕下载** - 获取视频的中文字幕 |
| 9 | 3. **格式转换** - 自动转换为 Markdown 格式(时间戳 + 文本) |
| 10 | 4. **批量处理** - 并发下载多个视频字幕(3并发) |
| 11 | 5. **智能命名** - 使用视频标题作为文件名 |
| 12 | |
| 13 | ## 使用场景识别 |
| 14 | |
| 15 | 根据用户请求自动识别需要的功能: |
| 16 | |
| 17 | - "搜索 Python 教程" → 执行视频搜索(根据用户需求拆分多个关键词) |
| 18 | - "下载 BV1xxx 的字幕" → 下载单个视频字幕 |
| 19 | - "批量下载这些视频的字幕" → 批量下载 |
| 20 | - "获取这个视频的文字内容" → 下载字幕并展示 |
| 21 | - "分析这个视频讲了什么" → 下载字幕并总结 |
| 22 | |
| 23 | ## 配置管理 |
| 24 | |
| 25 | ### Cookie 配置 |
| 26 | |
| 27 | 字幕 API 需要登录认证。配置文件位于: |
| 28 | ``` |
| 29 | ~/.claude/skills/bilibili-subtitle-fetcher/config.txt |
| 30 | ``` |
| 31 | |
| 32 | **格式**: |
| 33 | ``` |
| 34 | SESSDATA=你的SESSDATA值 |
| 35 | bili_jct=你的bili_jct值 |
| 36 | DedeUserID=你的用户ID |
| 37 | ``` |
| 38 | |
| 39 | **获取方式**: |
| 40 | 1. 登录 bilibili.com |
| 41 | 2. 打开浏览器开发者工具(F12) |
| 42 | 3. 进入 Application/存储 → Cookies |
| 43 | 4. 复制以上三个值 |
| 44 | |
| 45 | **检查配置**: |
| 46 | 如果下载失败,提示用户检查 Cookie 是否配置/过期。 |
| 47 | |
| 48 | ### 输出目录 |
| 49 | |
| 50 | 默认保存到: |
| 51 | ``` |
| 52 | ~/.claude/skills/bilibili-subtitle-fetcher/subtitles/ |
| 53 | ``` |
| 54 | |
| 55 | 如果用户指定其他目录,可以通过环境变量传递: |
| 56 | ```bash |
| 57 | OUTPUT_DIR=/Users/xxx/Documents python3 bili_simple.py download BV号 |
| 58 | ``` |
| 59 | |
| 60 | ## 高级功能 |
| 61 | |
| 62 | ### 1. 字幕内容分析 |
| 63 | |
| 64 | 下载后可以进行: |
| 65 | - 关键词提取 |
| 66 | - 主题总结 |
| 67 | - 时间轴分析 |
| 68 | - 内容问答 |
| 69 | |
| 70 | ### 2. 与其他 Skills 协作 |
| 71 | |
| 72 | - **cheap-summarizer**: 总结长字幕内容 |
| 73 | - **文档处理**: 转换为其他格式(PDF、DOCX) |
| 74 | - **数据分析**: 提取关键词和统计信息 |
| 75 | |
| 76 | ## 注意事项 |
| 77 | |
| 78 | 1. **Cookie 有效期**: SESSDATA 约 30 天有效,过期需重新获取 |
| 79 | 2. **请求频率**: 已内置随机延迟,建议批量不超过 10 个视频 |
| 80 | 3. **字幕质量**: AI 生成的字幕可能有误差 |
| 81 | |
| 82 | ## 技术细节 |
| 83 | |
| 84 | ### API 接口 |
| 85 | - 搜索: `api.bilibili.com/x/web-interface/search/type` |
| 86 | - 视频信息: `api.bilibili.com/x/web-interface/view` |
| 87 | - 字幕: `api.bilibili.com/x/player/v2` |
| 88 | |
| 89 | ### 并发控制 |
| 90 | - 最大并发数: 3 |
| 91 | - 随机延迟: 1-3 秒 |
| 92 | - 超时设置: 10 秒 |
| 93 | |
| 94 | ### 文件格式 |
| 95 | - 输出格式: Markdown |
| 96 | - 编码: UTF-8 |
| 97 | - 时间戳格式: mm:ss 或 hh:mm:ss |
| 98 | |
| 99 | ## 示例命令 |
| 100 | |
| 101 | ```bash |
| 102 | # 搜索 |
| 103 | python3 bili_simple.py search "关键词" |
| 104 | |
| 105 | # 单个下载 |
| 106 | python3 bili_simple.py download BV号 |
| 107 | |
| 108 | # 批量下载 |
| 109 | python3 bili_simple.py batch BV1 BV2 BV3 |
| 110 | ``` |