get_video_transcript
Extract Bilibili video subtitles as plain text, with options for time-range filtering, keyword search, and multi-part selection.
Instructions
获取 Bilibili 视频纯字幕文本（按行合并）。支持分集选择、时间戳输出、时间区间过滤和可选关键词搜索。不自动降级到描述；仅在 fallback_to_description 为 true 且字幕不可用时返回视频描述。关键词搜索与描述降级不兼容。Requires Bilibili Cookie for reliable subtitle access. If unavailable, call get_credential_setup_instructions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 可选，多P视频的分集编号（从1开始的正整数）。不指定时使用默认Part。 | |
| query | No | 可选，关键词搜索。大小写不敏感的字面匹配。非空且最多100字符。与 description 降级不兼容。 | |
| bvid_or_url | Yes | Bilibili 视频 BV 号或完整 URL | |
| end_seconds | No | 可选，字幕区间结束秒数（非负整数或小数）。只返回 from <= end_seconds 的字幕段。当同时提供 start_seconds 和 end_seconds 时需 end_seconds >= start_seconds。 | |
| max_matches | No | 可选，最大返回匹配数（1-20，默认10）。仅在 query 存在时生效。 | |
| start_seconds | No | 可选，字幕区间起始秒数（非负整数或小数）。只返回 to >= start_seconds 的字幕段。 | |
| preferred_lang | No | 可选，指定偏好字幕语言代码，如 'zh-Hans', 'en' 等。 | |
| context_segments | No | 可选，每个匹配前后的字幕段上下文数量（0-5，默认1）。仅在 query 存在时生效。 | |
| include_timestamps | No | 可选，为每行字幕添加 [HH:MM:SS --> HH:MM:SS] 时间戳前缀。默认 false。 | |
| fallback_to_description | No | 字幕不可用时是否降级为视频描述文本。默认 false。与时间戳/区间过滤器不兼容。 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bvid | Yes | ||
| page | No | ||
| query | No | ||
| title | Yes | ||
| matches | No | ||
| language | No | ||
| truncated | No | ||
| source_url | Yes | ||
| transcript | Yes | ||
| data_source | Yes | ||
| total_matches | No | ||
| returned_matches | No |