youtube-channels

核心功能

youtube-channels 是基于 TranscriptAPI.com 的 YouTube 频道数据获取工具，提供四大核心能力：

1. 频道解析（FREE）：将 @handle、频道 URL 或 UC... ID 统一解析为标准频道 ID
2. 最新视频（FREE）：通过 RSS 获取频道最近 15 条上传，含精确播放量和评分数据
3. 完整遍历（1 credit/页）：分页获取频道全部上传视频（每页100条），支持续传
4. 频道内搜索（1 credit）：在指定频道内关键词搜索，结果可控（1-50条）

显著优点

• 免费友好：注册即送 100 credits，核心解析和最新视频接口完全免费
• 输入灵活：统一接受 @handle、完整 URL 或 UC... ID，无需预解析
• 数据完整：返回 ISO 时间戳、精确播放量、缩略图、频道元数据等结构化信息
• 速率充足：300 req/min 免费额度，满足个人及中小项目需求
• 认证便捷：支持 CLI 一键注册验证，自动注入环境变量

局限与风险

• 依赖第三方服务：TranscriptAPI.com 的稳定性、数据更新延迟及长期运营存在不确定性
• 付费墙限制：完整遍历和搜索消耗 credits，大规模采集需付费（$0.01/credit 起）
• 地理/内容限制：YouTube 区域限制内容可能无法完整获取
• 速率风险：高频调用可能触发 402/429 错误，需实现退避重试

适用人群

内容创作者监测竞品、研究人员分析频道趋势、开发者构建 YouTube 数据应用、自动化工作流用户。

安全建议

• API Key 存储于 ~/.transcriptapi 及 shell profile，注意文件权限（建议 600）
• 避免在 CI/共享环境硬编码密钥，优先使用环境变量注入
• 定期检查 credits 消耗，设置用量告警防止意外超支

核心功能

youtube-channels 是由 TranscriptAPI.com 官方维护的 YouTube 频道数据工具，提供四大核心能力：

1. 频道解析（免费）：将 @handle、URL 或模糊的频道标识转换为标准 UC... ID
2. 最新视频（免费）：通过 RSS 获取频道最近 15 条上传，包含精确播放量、评分和 ISO 时间戳
3. 完整上传列表（1积分/页）：分页获取频道全部视频（每页100条），支持续传翻页
4. 频道内搜索（1积分）：在特定频道内精准搜索关键词

显著优势

• 输入灵活：直接接受 @TED、youtube.com/@TED 或 UC... ID，无需预处理
• 免费额度充足：新用户注册即送 100 积分，resolve 和 latest 端点完全免费
• 数据质量高：RSS 源提供官方精确的 viewCount 和 starRating，非估算值
• 零依赖轻量：仅使用 Node.js 内置模块，无第三方依赖风险
• 安全可信：通过 CLS-Certify S 级认证，T2 可信来源，HTTPS + Bearer Token 全程加密

局限性与风险

• 付费墙限制：完整上传列表和搜索功能消耗积分，高频使用需付费（$5/1000积分起）
• 外部服务依赖：完全依赖 transcriptapi.com 可用性，无本地降级方案
• 配额管理：402 错误需用户自行处理，缺少内置配额预检机制
• 配置侵入性：认证脚本会修改用户 shell RC 文件和 Agent 配置目录，虽属必要但透明度可提升

适合人群

• 内容创作者：监控竞品频道更新、分析爆款视频数据趋势
• 研究人员：批量获取教育/新闻频道（如 TED、NASA）的完整内容库
• 自动化工作流：结合 youtube-transcript 技能构建"监控-转录-摘要" pipeline

使用建议

优先使用免费端点完成频道识别和最新内容监控，付费功能用于深度归档需求。建议在 .zshrc 或 CI/CD 中显式设置 TRANSCRIPT_API_KEY 环境变量，避免依赖自动配置注入。