youtube-channels

核心用法

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

1. 频道解析 (/channel/resolve) — 将 @handle、URL 或模糊输入转换为标准 UC... 频道 ID，完全免费
2. 最新视频 (/channel/latest) — 通过 RSS 获取频道最近 15 条视频，含精确播放量、评分、缩略图，免费
3. 完整视频列表 (/channel/videos) — 分页获取频道全部上传内容（100条/页），消耗 1 credit/页
4. 频道内搜索 (/channel/search) — 在指定频道内关键词检索，消耗 1 credit/次

典型工作流：先用 resolve 获取频道 ID → latest 查看最新动态 → 如需深度分析可调用 videos 或 search，最后结合 transcript API 获取视频字幕。

显著优点

• 成本友好：解析和最新视频接口完全免费，100 credits 初始额度足够小规模使用
• 数据精准：RSS 源提供精确到个位数的播放量和 ISO 8601 标准时间戳
• 开发体验：返回结构清晰的 JSON，包含 continuation token 实现可靠分页
• Handle 支持：原生支持 YouTube 新 @handle 格式，无需手动转换

潜在局限

• 依赖第三方服务：TranscriptAPI 为商业 API，存在服务中断或定价变更风险
• 额度消耗：完整视频列表和搜索功能按调用计费，大规模监控成本累积
• 无实时推送：latest 端点基于 RSS 轮询，延迟取决于 RSS 更新频率
• 地区限制：部分频道可能因地区限制无法解析

适合人群

• 内容创作者监控竞品频道动态
• 市场研究员批量获取 YouTube 数据
• 自动化工作流开发者（配合 n8n、Make 等工具）
• 需要结构化频道数据的分析师

常规风险

• API Key 泄露：sk_ 开头的密钥需妥善保管，建议配置环境变量而非硬编码
• 额度超支：402 错误表示额度耗尽，需提前规划监控频率
• 服务依赖：单一供应商风险，关键业务建议设计降级方案
• 合规边界：大规模爬取需遵守 YouTube ToS 及当地数据法规

核心功能

YouTube Channels Skill 提供一站式 YouTube 频道数据查询能力，涵盖四大核心接口：

1. 频道解析（resolve）：免费将 @handle、频道 URL 或 UC...ID 转换为标准频道 ID
2. 最新视频（latest）：免费获取频道最近 15 条上传，包含精确播放量、评分、时间戳
3. 历史浏览（videos）：分页获取全部上传（100条/页，消耗1 credit/页）
4. 站内搜索（search）：在指定频道内关键词搜索（消耗1 credit）

显著优势

• 成本友好：核心功能（解析+最新视频）完全免费，仅需 API Key 无需消耗 credits
• 数据精准：通过 RSS 聚合获取实时数据，播放量、时间戳均为官方精确值
• 工作流完整：从 handle → ID → 最新视频 → 字幕下载，形成闭环工具链
• 无第三方依赖：纯 Node.js 实现，供应链攻击面极小

潜在局限

• 外部服务依赖：核心功能完全依赖 TranscriptAPI.com，若服务中断则不可用
• T3 来源风险：个人开发者维护（therohitdas），无企业级 SLA 保障
• 配置文件修改：认证脚本会写入 ~/.bashrc、~/.zshenv 等 shell 配置，需用户知情
• 免费额度限制：100 credits/月，高频爬取需付费升级

适合人群

• 内容创作者追踪竞品频道动态
• 研究人员批量获取频道元数据
• 自媒体运营监控多账号更新
• 需要精确播放数据（非估算）的分析场景

常规风险提示

• API Key 以 Bearer Token 形式传输，存储于 ~/.transcriptapi（权限 0o600），相对安全
• 禁止临时邮箱注册，需真实邮箱完成 OTP 验证
• 网络流量均限于 transcriptapi.com 域名，无数据外泄至第三方