subtitles

核心用法

Subtitles 技能通过调用 TranscriptAPI.com 服务，提取 YouTube 视频的字幕内容。支持多种输出格式：format=text 获取纯净文本便于翻译阅读，format=json 获取带时间戳的结构化数据用于同步跟读。可通过 include_timestamp 参数控制是否包含时间信息，send_metadata 获取视频元数据。

显著优点

• 多语言支持：自动识别视频可用字幕语言，包括自动生成字幕
• 灵活输出：JSON 格式适合开发集成，纯文本适合直接阅读翻译
• 低门槛接入：100 次免费额度，无需绑卡即可体验
• 时间戳精确：支持逐句时间定位，便于语言学习时的同步跟读

潜在缺点与局限性

• 依赖第三方服务：TranscriptAPI.com 的稳定性与持续性直接影响功能可用
• 额度限制：免费仅 100 credits，重度使用需付费
• 仅支持 YouTube：无法处理其他平台视频
• 字幕质量参差：依赖视频上传者或 YouTube 自动生成，准确性不一
• API Key 管理：需用户手动完成注册验证流程，对非技术用户有一定门槛

适合人群

• 外语学习者（需要带时间戳的跟读材料）
• 翻译工作者（需要批量提取视频文本）
• 内容创作者（需要引用视频原文）
• 研究人员（需要分析视频语音内容）

常规风险

• 隐私风险：需向第三方服务提供邮箱注册，API 调用记录可能被记录
• 服务中断风险：小众第三方 API 存在关停或变更定价可能
• 内容合规：提取的字幕版权归原视频所有，商用需注意授权

核心用法

Subtitles 是一款专为 YouTube 视频设计的字幕提取工具，通过 TranscriptAPI.com 服务实现核心功能。用户只需提供视频 URL 或 ID，即可获取多语言字幕文本，支持两种输出格式：

• JSON 格式：带时间戳的分段数据，适合同步阅读、字幕编辑
• 纯文本格式：干净文字，适合翻译软件处理或语言学习笔记

认证流程采用无密码设计：用户邮箱注册 → 接收 6 位 OTP → 验证后自动写入 API 密钥到 shell 配置（~/.zshenv、~/.bashrc 等）和 ~/.transcriptapi 文件。新用户享 100 免费额度，无需绑定信用卡。

显著优点

1. 多语言支持：自动识别视频可用字幕语言，包括自动生成字幕
2. 灵活输出：时间戳可开关，兼顾精读与泛读场景
3. 低门槛认证：密码less流程，邮箱即走
4. 元数据完整：可选获取标题、频道、视频描述
5. 成本友好：1 积分/请求，免费额度充足

潜在局限

• 第三方依赖：功能完全依赖 TranscriptAPI.com 服务可用性，无本地降级方案
• 仅支持 YouTube：不支持其他视频平台
• T3 来源：个人开发者维护，长期稳定性存疑
• 配置文件写入：需修改用户 shell 配置文件，虽已实现安全备份逻辑，但部分用户可能介意

适合人群

• 外语学习者：提取视频文本制作学习材料
• 翻译工作者：获取源文字批量处理
• 内容创作者：整理视频脚本、生成笔记
• 无障碍需求用户：将视频内容转为可读文本

常规风险

• 402 错误：额度耗尽需付费充值
• 404 错误：视频无字幕或地区限制
• 408 超时：网络波动时需手动重试
• 隐私注意：邮箱和观看记录相关的视频 URL 会传输至第三方服务

安全评估摘要

该 Skill 通过 CLS-Certify v2.1.0 六维扫描，获 S 级认证（82 分）。代码结构清晰，无危险函数、无硬编码密钥、无恶意模式。仅使用 Node.js 内置模块，零外部依赖。网络通信全 HTTPS 指向单一可信域名。文件系统操作为合理配置管理，已实现重复检测与安全备份。