yt

核心功能

yt 是一个轻量级 YouTube 内容分析工具，通过 TranscriptAPI.com 提供三项核心能力：

1. 视频转录提取（1 积分）— 获取任意 YouTube 视频的完整字幕文本，支持带时间戳格式和元数据
2. 视频/频道搜索（1 积分）— 按关键词检索视频或频道，最多返回 50 条结果
3. 频道最新视频（免费）— 无需积分获取频道最近 15 个视频的数据，包含精确观看数和发布日期
4. 频道句柄解析（免费）— 将 @username 格式转换为标准的 UC 格式频道 ID

显著优点

• 快速响应：curl 命令行直接调用，无复杂 SDK 依赖
• 成本友好：100 积分免费额度，两项常用功能（频道最新、句柄解析）完全免费
• 格式灵活：转录支持纯文本、带时间戳等多种输出格式
• 元数据完整：返回观看数、发布日期等结构化数据，便于分析

潜在局限

• 依赖第三方服务：TranscriptAPI.com 是独立商业服务，非 YouTube 官方 API，存在服务稳定性风险
• 积分付费模式：免费额度用尽后需付费（$0.01-0.02/积分），高频使用成本累积
• 转录限制：无字幕/关闭字幕的视频返回 404，不支持自动语音转录
• 地理限制：部分区域 YouTube 内容可能因版权/合规原因无法获取

适用人群

内容创作者、研究人员、播客制作团队、需要批量分析 YouTube 内容的自动化工作流开发者

常规风险

| 风险类型 | 说明 |

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

| 服务中断 | 第三方 API 变更或停止服务将导致技能失效 |

| 数据隐私 | 视频查询记录留存于 TranscriptAPI.com 服务器 |

| 配额耗尽 | 402 错误需手动充值，自动化流程需监控余额 |

| 版权合规 | 转录内容受原视频版权保护，商用需取得授权 |

核心用法

yt 是一个轻量级 YouTube 工具 Skill，通过 TranscriptAPI.com 提供三项核心能力：

1. 视频字幕获取 — 1 credit/次，支持时间戳和元数据，可将 YouTube 视频转为可搜索文本
2. 视频/频道搜索 — 1 credit/次，关键词搜索返回前50条结果
3. 频道最新内容 — 免费，获取频道最近15个视频及精确播放数据

使用场景：当用户分享 YouTube 链接、询问"这个视频讲什么"、说"yt"或"youtube"、搜索特定主题视频、查看频道最新更新时触发。

显著优点

• 零依赖架构：仅使用 Node.js 内置模块，无第三方包风险
• 来源可信：TranscriptAPI.com 为正规商业 API 服务，HTTPS/TLS1.2+ 全链路加密
• 安全认证流程：注册分步验证（邮箱+OTP），支持临时邮箱拦截，API Key 多位置安全存储（~/.transcriptapi 权限 600）
• 成本透明：搜索/字幕各1积分，频道查询和 handle 解析完全免费，免费层100积分起步
• 配置自动化：save-key 命令自动配置 Agent 运行时、Shell 环境、Systemd/Fish/PowerShell 等多平台

潜在局限

• 完全外部依赖：所有功能依赖 TranscriptAPI.com 单点服务，若其不可用则 Skill 失效
• 网络无超时：内置 fetch 未设超时，弱网环境可能长时间挂起
• 配置文件广泛写入：自动修改 ~/.bashrc、~/.zshrc、~/.profile 等10余个配置文件，虽为功能必需但侵入性较强
• 付费墙风险：免费积分耗尽后需付费，高频使用场景成本累积
• 字幕覆盖率：依赖 YouTube 原生字幕，无人工字幕或创作者关闭字幕的视频无法获取

适合人群

• 需要快速总结 YouTube 视频内容的效率用户
• 追踪特定频道更新的内容创作者/研究者
• 构建视频知识库、做内容分析的知识工作者
• 能管理 API 积分预算、接受第三方服务依赖的用户

常规风险

• API Key 泄露：存储于多处配置文件，多设备同步时需注意权限
• 服务条款变更：第三方 API 政策调整可能影响可用性或定价
• 隐私边界：视频 URL、搜索关键词发送至外部服务，敏感内容需谨慎
• 积分误消耗：搜索和字幕操作易误触发，建议用户了解 1 credit/次的成本