SRT 字幕转结构化数据

将 SRT 字幕文件解析为结构化 JSON 格式，支持提取时间码、计算时长、生成统计信息。

快速开始

基础用法

解析 SRT 文件，输出到终端

python <skill_path>/scripts/parse_srt.py input.srt

输出到文件

python <skill_path>/scripts/parse_srt.py input.srt -o output.json

包含统计信息

python <skill_path>/scripts/parse_srt.py input.srt --stats

仅输出纯文本（去除时间码）

python <skill_path>/scripts/parse_srt.py input.srt --text-only

注意： <skill_path> 是此 skill 的安装路径，通常为 ~/.claude/plugins/srt-to-structured-data@claude-code-skills/skills/srt-to-structured-data

输出格式

JSON 结构化数据

{ "subtitles": [ { "index": 1, "start_time": "00:00:00,000", "end_time": "00:00:02,566", "start_ms": 0, "end_ms": 2566, "duration_ms": 2566, "text": "Clawdbot真的太火太火太火了" }, { "index": 2, "start_time": "00:00:02,633", "end_time": "00:00:04,766", "start_ms": 2633, "end_ms": 4766, "duration_ms": 2133, "text": "Github一天直接涨了5万星" } ], "statistics": { "total_count": 2, "total_duration_ms": 4699, "total_duration_formatted": "00:04", "avg_duration_ms": 2349 } }

纯文本输出

使用 --text-only 参数时，仅输出字幕文本，每条一行：

Clawdbot真的太火太火太火了 Github一天直接涨了5万星

命令行参数

参数 说明

input.srt

输入的 SRT 字幕文件路径

-o, --output

输出文件路径（默认输出到终端）

--stats

在 JSON 输出中包含统计信息

--text-only

仅输出纯文本，去除时间码和序号

字段说明

字段 类型 说明

index

int 字幕序号

start_time

string 开始时间（原始格式）

end_time

string 结束时间（原始格式）

start_ms

int 开始时间（毫秒）

end_ms

int 结束时间（毫秒）

duration_ms

int 持续时长（毫秒）

text

string 字幕文本内容

使用示例

场景 1：分析字幕文件

python <skill_path>/scripts/parse_srt.py video.srt --stats -o analysis.json

场景 2：提取纯文本用于翻译

python <skill_path>/scripts/parse_srt.py video.srt --text-only -o transcript.txt

场景 3：在 Python 中直接使用

import subprocess import json

result = subprocess.run( ['python', '<skill_path>/scripts/parse_srt.py', 'input.srt', '--stats'], capture_output=True, text=True ) data = json.loads(result.stdout)