subtitles

核心用法

Subtitles 技能通过 TranscriptAPI.com 服务获取YouTube视频的字幕内容，支持灵活的输出格式：

• 纯文本模式：format=text + include_timestamp=false，适合翻译、阅读或导入语言学习应用
• 结构化模式：format=json + include_timestamp=true，返回带时间戳的字幕片段，适合制作双语字幕或同步跟读

只需提供YouTube视频URL或视频ID，即可获取对应语言的字幕数据。支持人工上传字幕和自动生成的多语言字幕。

显著优点

1. 多场景适配：无论是翻译工作、外语学习、内容整理还是无障碍阅读，都能通过参数灵活调整输出格式
2. 低门槛入门：100次免费额度，无需绑定信用卡即可注册试用
3. 时间戳精准：JSON格式提供精确到0.1秒的同步信息，便于开发字幕工具或制作跟读材料
4. 元数据完整：可选获取视频标题、频道、描述等信息，便于内容管理

潜在缺点与局限性

• 依赖第三方服务：TranscriptAPI.com 的稳定性和持续性决定技能可用性
• 额度消耗：每次请求消耗1积分，免费额度有限，重度使用需付费
• 字幕覆盖不全：部分视频无字幕或仅限特定语言，可能返回404错误
• 网络延迟：408超时错误表明偶发不稳定，需重试机制
• 无直接翻译功能：仅提取原文，翻译需借助其他工具

适合人群

• 语言学习者：获取目标语言视频文本，导入Anki等记忆工具
• 翻译工作者：快速提取视频原文字幕作为翻译参考
• 内容创作者：整理视频文案、制作引用或二次创作
• 研究人员：批量获取视频文本数据进行内容分析
• 听障用户：将视频内容转为可读文本

常规风险

| 风险类型 | 说明 |

|---------|------|

| API密钥安全 | 密钥存储于本地shell配置文件，需确保设备安全 |

| 隐私合规 | 提取的视频内容可能受版权保护，商用需注意授权 |

| 服务依赖 | 第三方API变更或终止可能影响功能 |

| 数据准确性 | 自动生成字幕可能存在识别错误，关键用途建议人工校对 |

核心功能

subtitles 是一个专用于提取 YouTube 视频字幕的 Skill，通过调用 TranscriptAPI.com 官方服务实现。支持获取自动生成或上传的字幕内容，提供 json（带时间戳）和 text（纯文本）两种输出格式，适用于语言学习、翻译辅助、视频内容阅读等多种场景。

显著优点

• 多格式输出灵活：format=json 提供逐句时间戳，适合跟读同步；format=text + include_timestamp=false 输出干净文本，适合导入翻译工具或阅读
• 多语言支持：可获取视频可用的多种语言字幕，包括自动生成字幕
• 元数据完整：可选获取视频标题、频道、描述等信息
• 零第三方依赖：代码仅使用 Node.js 内置模块（fs, path, os），无 npm 供应链风险
• 免费额度友好：100 次免费请求，无需绑定信用卡即可注册

潜在局限与风险

| 方面 | 说明 |

|------|------|

| **服务依赖** | 完全依赖 TranscriptAPI.com 的可用性，服务中断则 Skill 失效 |

| **来源可信度** | 维护者为个人开发者（T3），无知名组织背书，需用户自行评估信任 |

| **配置修改** | 自动注册流程会修改用户 shell 配置文件（.bashrc/.zshenv 等）以保存 API Key，虽为功能必需，但敏感用户可能介意 |

| **额度限制** | 免费仅 100 次/月，重度使用需付费（$10/1000 次） |

| **版权注意** | 获取的字幕仅限个人学习使用，商用或再分发可能涉及版权风险 |

适合人群

• 语言学习者：获取目标语言视频字幕进行阅读、翻译和跟读训练
• 内容创作者：需要引用或分析视频文本内容
• 研究者：批量获取视频文本数据进行内容分析（需遵守服务条款）
• 无障碍需求用户：偏好阅读而非观看视频内容

安全评估

• 安全等级：A — 无恶意代码、无危险函数、无数据外泄
• 主要扣分项：脚本修改 shell 配置文件保存 API Key（功能必需，已做跨平台适配）
• 网络行为：仅访问 transcriptapi.com 官方 HTTPS 端点，无可疑域名
• 隐私合规：收集邮箱仅用于注册，无追踪代码，符合 GDPR 数据最小化原则

使用建议

敏感用户可跳过自动注册，手动通过 transcriptapi.com/signup 获取 API Key 后，自行在 shell 配置中设置 TRANSCRIPT_API_KEY，避免脚本修改配置文件。