youtube-channels

核心用法

YouTube Channels 技能提供四大核心功能：

1. 频道解析 (/resolve) — 免费，将 @handle、频道URL或 UC... ID 转换为标准频道ID
2. 最新视频 (/latest) — 免费，通过RSS获取频道最近15条视频，含精确播放量、评分、ISO时间戳
3. 全库翻页 (/videos) — 1积分/页，分页获取频道全部上传内容（每页100条），支持continuation令牌续翻
4. 频道内搜索 (/search) — 1积分/次，在指定频道内关键词检索，返回1-50条结果

输入灵活：所有端点直接接受 @TED、https://youtube.com/@NASA 或 UC... 格式，无需预解析。

显著优点

• 官方数据源：TranscriptAPI.com 运营，非第三方 scraping，稳定性有保障
• 免费层友好：解析+最新视频完全免费，仅消耗额度；新用户赠100积分
• RSS精准度：/latest 基于YouTube官方RSS，播放量、时间戳准确，适合监控频道动态
• 无缝衔接转录：与同一平台的 youtube-transcript 技能配合，形成「发现视频→提取字幕」工作流

潜在缺点与局限

• 额度消耗：全库翻页和频道搜索消耗积分，大型频道深度挖掘成本累积
• 无视频元数据细节：相比 YouTube Data API，缺少评论数、完整标签、类别ID等字段
• 依赖外部服务：TranscriptAPI.com 若调整定价或下线，技能即失效
• RSS延迟：/latest 依赖RSS同步，极端情况下新视频可能有分钟级延迟

适合人群

• 内容创作者监控竞品频道更新
• 研究人员批量获取特定频道历史视频清单
• 播客/媒体剪辑师快速定位频道内某主题视频（配合频道搜索）
• 需低成本替代 YouTube Data API v3 配额的开发者

常规风险

• API密钥泄露：TRANSCRIPT_API_KEY 写入 shell 配置文件，多用户环境需注意权限
• 额度超支：免费额度耗尽后需付费，高频调用建议前置检查余额
• 输入误解析：非常规URL格式（短链、跟踪参数）可能触发422错误，建议优先使用 @handle 或标准 UC... ID

核心用法

youtube-channels 是一套基于 TranscriptAPI.com 的 YouTube 频道工具集，主要功能包括：

• 频道 ID 解析 (/channel/resolve): 将 @handle、频道 URL 或 UC... ID 转换为标准频道 ID，完全免费
• 最新视频获取 (/channel/latest): 获取频道最近 15 个视频，含精确播放数据和时间戳，免费
• 完整上传列表 (/channel/videos): 分页获取频道所有视频（每页 100 条），每页消耗 1 积分
• 频道内搜索 (/channel/search): 在指定频道内搜索视频，每次消耗 1 积分

使用流程简洁：通过 @handle 直接调用 latest 端点免费获取最新内容，或配合 transcript 技能获取视频转录文本。

显著优点

1. 零门槛免费起步：注册即赠 100 积分，resolve 和 latest 端点完全免费，无需绑定信用卡
2. 输入格式智能：支持 @TED、youtube.com/@TED、UC... ID 等多种格式，自动识别无需预处理
3. 数据完整准确：提供 ISO 时间戳、精确播放数、评分数据等 YouTube RSS 原生字段
4. 无依赖部署：纯 Node.js 原生实现，零第三方依赖，供应链风险极低
5. 配置自动化：API Key 自动注入 shell 配置文件，终端和 Agent 环境无缝衔接

潜在缺点与局限性

1. 外部服务强依赖：功能完全绑定 TranscriptAPI.com，服务中断即不可用，无本地降级方案
2. 付费墙渐进式：除基础端点外，视频列表和搜索均需消耗积分，高频使用需付费
3. 无内置重试机制：408 超时等临时错误需用户手动重试
4. 数据无缓存：重复查询相同频道会重复消耗积分，缺乏智能缓存策略
5. 地理限制未明：未说明是否支持区域限制内容或 YouTube Premium 专属视频

适合人群

• 内容研究者：需要批量获取频道元数据、监控更新动态
• 媒体分析师：提取视频标题、播放量、发布时间等结构化数据
• 自动化工作流构建者：与 transcript 技能联动，实现「监控→转录→分析」流水线
• 轻量级用户：偶尔查询频道最新内容，免费额度充足

常规风险

| 风险类别 | 说明 | 等级 |

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

| 服务可用性 | TranscriptAPI 单点故障风险 | 中 |

| 成本失控 | 积分消耗超出预期（搜索/分页场景） | 低 |

| 配置覆盖 | 自动写入 shell 配置文件可能覆盖用户自定义内容 | 低 |

| 数据时效 | RSS 源数据存在分钟级延迟 | 低 |

| 合规风险 | 需遵守 YouTube ToS 和 TranscriptAPI 使用条款 | 低 |