subtitles

核心用法

Subtitles 技能通过 TranscriptAPI.com 服务获取 YouTube 视频的字幕内容。用户只需提供视频 URL 或视频 ID，即可提取带时间戳的结构化字幕（JSON 格式）或纯净文本（适合翻译、阅读）。支持自动识别多语言字幕，包括人工上传和自动生成字幕。

显著优点

1. 低门槛接入：免费注册即可获得 100 credits（约 100 次请求），无需信用卡，适合个人轻量使用
2. 灵活输出格式：format=json 适合需要精准时间同步的场景（如跟读学习）；format=text + include_timestamp=false 适合直接阅读或输入翻译工具
3. 元数据丰富：可选获取视频标题、频道、描述等信息，便于内容管理
4. 多语言支持：自动检测并返回视频可用字幕语言，对学习外语、跨语言内容理解极有帮助

潜在缺点与局限性

• 依赖第三方服务：API 可用性和稳定性由 TranscriptAPI.com 决定，存在服务中断风险
• 字幕覆盖率非 100%：部分视频无字幕或创作者关闭字幕功能时会返回 404
• 免费额度有限：100 credits 用完后需付费（未披露具体定价），高频用户需考虑成本
• Cloudflare 防护严格：必须正确设置 User-Agent 头，否则会被 403/1010 拦截，对新手有一定调试成本
• 仅支持 YouTube：无法处理其他平台（Bilibili、Vimeo 等）

适合人群

• 语言学习者：提取外语视频字幕进行词汇学习、跟读训练
• 内容创作者/研究者：快速获取视频讲稿进行引用、分析、二次创作
• 无障碍需求用户：将视频内容转为可读文本
• 翻译工作者：获取源文本后进行机器翻译或人工翻译

常规风险

• API Key 泄露风险：需妥善保管 TRANSCRIPT_API_KEY，避免硬编码到公开仓库
• 隐私合规：提取的视频字幕可能受版权保护，商业使用前需确认授权
• 服务依赖：API 服务商可能调整定价或终止服务，建议关键业务准备备用方案

核心用法

subtitles Skill 通过调用 TranscriptAPI.com 服务，为任意YouTube视频提取带时间戳或纯文本格式的字幕内容。使用时需提供 YouTube 链接或视频ID，配置 TRANSCRIPT_API_KEY 环境变量后即可发起请求。

主要功能模式：

• 语言学习：format=text&include_timestamp=false 获取干净文本，便于阅读或导入翻译工具
• 翻译辅助：format=json&include_timestamp=true 获取分段带时间戳的字幕，支持精准对照
• 无障碍需求：时间戳同步字幕可帮助听障用户或需要跟读的学习者

显著优点

1. 零代码门槛：纯 Markdown 文档型 Skill，无需安装依赖或运行时环境
2. 多语言支持：自动获取视频可用的自动生成字幕或上传字幕，覆盖绝大多数YouTube内容
3. 格式灵活：JSON格式保留时间精度，纯文本格式优化阅读体验
4. 低成本试用：免费 tier 提供100次请求额度，无需绑定信用卡
5. CLS S级安全认证：通过全部静态分析、隐私合规和威胁情报检查

潜在缺点与局限性

• 第三方依赖：完全依赖 TranscriptAPI.com 的服务可用性，存在单点故障风险
• 字幕覆盖率：部分视频可能无字幕或仅有限语言支持，返回404错误
• 配额限制：免费额度仅100次/月，高频用户需付费升级
• 网络要求：必须保持联网状态，无法离线使用
• 来源可信度T3：社区项目级别，非企业级官方服务

适合人群

• 语言学习者（跟读、听力训练、生词提取）
• 内容创作者（视频翻译、二次剪辑脚本准备）
• 研究人员（访谈转录、讲座内容归档）
• 无障碍需求用户（听障辅助、慢速阅读）
• 翻译工作者（批量获取原文对照材料）

常规风险

• API Key 泄露风险：TRANSCRIPT_API_KEY 需妥善保管，泄露可能导致配额被盗用
• 403/1010 拦截风险：未正确配置 User-Agent 头部会导致 Cloudflare 阻断
• 服务终止风险：第三方 API 可能调整定价或停止运营，需关注官方公告
• 内容版权注意：提取的字幕版权归原视频创作者所有，商用需获得授权