youtube-channels

核心功能

youtube-channels 是 TranscriptAPI.com 提供的 YouTube 频道数据服务，提供四大核心能力：

1. 频道解析（免费）：将 @handle、URL 或 UC... ID 统一转换为标准频道 ID
2. 最新视频（免费）：获取频道最近 15 条视频，包含精确观看数、评分、ISO 时间戳
3. 历史归档（1 credit/页）：分页获取全部上传视频，每页 100 条，含缩略图与时长
4. 频道内搜索（1 credit）：在特定频道内搜索关键词，结果 1-50 条可调

显著优点

• 免费层级友好：resolve 和 latest 端点完全免费，100 credits 入门额度无需绑卡
• 数据精确度高：返回 RSS 源级别的精确观看数（非估算）和完整时间戳
• 开发者体验佳：RESTful 设计，参数验证严格，错误码清晰（402 欠费、404 频道不存在等）
• 工作流闭环：与 TranscriptAPI 的转录服务天然衔接，实现「找视频→取转录」一条龙

局限与风险

• 付费墙限制：历史视频浏览和搜索需消耗 credits，大规模数据采集成本上升
• 依赖第三方：数据来源于 YouTube RSS 与内部接口，YouTube 政策变更可能导致服务中断
• 速率限制：免费档 300 req/min，商业级需求需升级
• 无内容审核：返回原始频道与视频信息，不含暴力/成人内容过滤

适用人群

• 内容创作者监控竞品频道动态
• 研究者进行 YouTube 舆情分析或学术数据挖掘
• 媒体编辑快速追踪 KOL 最新发布
• 开发者构建 YouTube 数据聚合工具

常规风险提示

• API Key 需妥善保管，避免硬编码在开源仓库
• 大规模爬取可能触发频道的反爬机制，建议尊重 rate limit
• 转录服务涉及版权内容，商业使用需自行确认授权范围

核心用法

youtube-channels 是一个纯文档型 Skill，通过 TranscriptAPI.com 提供 YouTube 频道数据查询能力。主要功能包括：

1. 频道解析 (/api/v2/youtube/channel/resolve)：将 @handle、频道 URL 或变体 ID 转换为标准 24 字符 UC... 频道 ID，免费调用
2. 最新视频 (/api/v2/youtube/channel/latest)：获取频道最近 15 条上传，含精确播放量、评分和时间戳，免费调用
3. 视频列表 (/api/v2/youtube/channel/videos)：分页获取频道全部上传（每页 100 条），消耗 1 credit/页
4. 频道内搜索 (/api/v2/youtube/channel/search)：在指定频道内搜索视频，消耗 1 credit

典型工作流：先 resolve 解析频道 → latest 查看最新动态 → 结合 youtube-transcript Skill 获取视频转录。

显著优点

• 免费入口友好：解析和最新视频接口完全免费，仅需认证不消耗 credits
• 数据精确：直接对接 YouTube RSS，提供 ISO 8601 时间戳和精确播放统计
• Handle 支持：原生支持 @mkbhd 等现代 YouTube handle 格式，无需手动查找 ID
• 纯文档无代码：无可执行代码，所有调用均为标准 cURL 示例，透明可控
• 与转录服务打通：同一平台提供 transcript 接口，可构建完整的内容分析流程

潜在缺点与局限性

• 外部服务依赖：完全依赖 TranscriptAPI.com 的可用性和定价策略，非 YouTube 官方 API
• 信用额度限制：免费仅 100 credits，批量获取频道全量视频或频繁搜索易超额
• 个人开发者维护（T3）：非企业级服务，长期稳定性和 SLA 无保障
• 无实时推送：基于拉取模式，无法实时监测新视频发布
• 地理/内容限制：受 YouTube 区域限制和创作者隐私设置影响

适合人群

• 内容创作者和研究者需要批量分析特定 YouTube 频道
• AI 工作流需要结构化频道元数据作为输入
• 播客/媒体监控场景，需跟踪 KOL 最新发布
• 轻量级使用场景，免费额度足够覆盖需求

常规风险

• API 密钥泄露：TRANSCRIPT_API_KEY 需存储在环境变量，硬编码或日志泄露会导致额度被盗用
• 服务商变更：个人项目可能停止维护或调整定价，存在供应商锁定风险
• 数据隐私：频道查询行为会暴露至 TranscriptAPI，敏感频道监测需注意合规性
• 速率限制：300 req/min 对高频场景可能不足，需实现退避重试逻辑

使用建议

1. 优先使用 resolve + latest 免费组合满足日常监控需求
2. 通过 continuation 分页谨慎使用 videos 接口，避免不必要 credit 消耗
3. 定期检查 transcriptapi.com Dashboard 监控额度使用
4. 生产环境建议评估官方 YouTube Data API 作为备选方案