yt

功能概述

yt 是一款面向开发者和内容工作者的YouTube工具集skill，通过TranscriptAPI.com提供四项核心能力：视频字幕提取（1积分）、视频/频道搜索（1积分）、频道最新视频获取（免费）、@handle转Channel ID（免费）。

核心用法

| 场景 | 调用示例 |

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

| 获取视频字幕 | `curl .../youtube/transcript?video_url=URL&format=text` |

| 搜索视频 | `curl .../youtube/search?q=QUERY&type=video&limit=10` |

| 频道最新视频 | `curl .../youtube/channel/latest?channel=@TED` |

| 解析频道ID | `curl .../youtube/channel/resolve?input=@handle` |

显著优点

• 零门槛起步：100免费积分，无需信用卡
• 结构化输出：支持JSON格式、时间戳、元数据附加
• 成本透明：搜索和字幕各1积分，频道查询完全免费
• 多格式支持：纯文本、带时间戳文本、完整JSON可选

局限性与风险

| 类别 | 说明 |

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

| 依赖外部服务 | 完全依赖TranscriptAPI.com的可用性与定价策略 |

| 字幕覆盖率 | 404错误提示"无字幕"，对无人工/自动字幕视频无效 |

| 积分消耗 | 高频使用需付费（transcriptapi.com/billing） |

| 认证流程 | 需用户完成邮箱注册→OTP验证→密钥注入，交互链较长 |

适合人群

• 需要批量分析YouTube内容的研究者、记者
• 构建视频摘要、问答系统的AI开发者
• 监控特定频道更新的运营人员

安全提示

• API密钥存储于~/.transcriptapi和shell profile，注意文件权限
• 建议定期轮换密钥，避免泄露导致积分被盗刷
• 402/404/408错误码需程序化处理，避免无限重试

核心功能

yt 是一款专注于 YouTube 数据的轻量级工具，通过 TranscriptAPI.com 提供专业级 API 服务。主要功能涵盖三大场景：

1. 字幕获取（Transcript）——输入视频 URL 即可提取完整字幕文本，支持带时间戳格式，适用于视频内容速览、摘要生成或无障碍辅助
2. 视频搜索（Search）——按关键词检索 YouTube 视频或频道，支持结果数量控制（1-50 条）
3. 频道追踪（Channel Latest）——获取指定频道的最新 15 条视频，含精确观看数与发布日期，完全免费

此外还提供频道句柄解析功能，支持 @handle、UC... ID 与频道 URL 之间的灵活转换。

显著优势

• 零依赖架构：纯 Node.js 原生 API 实现，无第三方 npm 包，彻底规避供应链攻击风险
• 安全认证流程：采用密码less设计，邮箱 OTP 验证，API Key 存储权限严格控制为 0o600
• 透明计费模式：免费 tier 含 100 credits，字幕与搜索各消耗 1 credit，频道查询免费
• 代码质量优异：安全扫描综合评分 88/A 级，静态分析 90 分、动态分析 95 分，未发现危险函数或注入漏洞
• 合规保障：通过 GDPR 数据最小化、CCPA 用户知情权、TLS 1.2+ 加密传输等六项合规检查

潜在局限

• 外部服务依赖：核心功能完全依赖 TranscriptAPI.com 的可用性与定价策略，存在供应商锁定风险
• 配额限制：免费 credits 用完后需付费订阅，高频使用场景需评估成本
• 网络要求：所有功能均需联网，离线环境无法使用
• 字幕覆盖不全：部分视频无人工字幕或自动字幕时返回 404
• 许可证缺失：当前未声明开源许可证，存在法律不确定性

适用人群

• 需要批量处理 YouTube 内容的开发者、研究员、内容创作者
• 追求供应链安全、倾向零依赖部署的技术团队
• 需快速获取视频摘要而不观看完整内容的效率用户
• 关注隐私合规、希望避免直接访问 YouTube 数据的企业场景

常规风险提示

• 凭证管理：API Key 需妥善保管，避免意外提交至版本控制
• 配置文件修改：Skill 会自动写入 shell 配置文件（~/.zshenv、~/.bashrc 等）以持久化环境变量，用户应知晓此行为
• 临时邮箱限制：注册时屏蔽一次性邮箱域名，需使用真实邮箱
• 服务连续性：建议关注 TranscriptAPI.com 的服务状态，关键业务需考虑降级方案