youtube-channels

核心用法

YouTube Channels 技能基于 TranscriptAPI.com 提供四项核心能力：

1. 频道解析 (/resolve) — 将 @handle、URL 或模糊输入转换为标准频道 ID（UC...），完全免费
2. 最新视频 (/latest) — 获取频道最近 15 条上传，包含精确播放量、发布时间戳、缩略图，RSS 驱动无需消耗额度
3. 视频列表 (/videos) — 分页抓取全部上传历史（100条/页），每次翻页消耗 1 credit
4. 频道内搜索 (/search) — 在特定频道中关键词检索，支持 1-50 条结果限制

典型工作流：解析 handle → 查看最新动态 → 获取视频详情/字幕（配合 transcript 技能）

显著优点

• 零门槛起步：100 free credits 无需绑卡，resolve 和 latest 接口免费使用
• 数据精确：RSS 源提供 ISO 8601 时间戳和完整播放统计，优于 YouTube 网页的模糊计数（如"3.2M views"）
• 灵活输入：支持 @handle、任意格式 URL、UC ID 三种解析方式
• 分页完善：continuation token 机制可遍历整个频道历史

潜在缺点与局限

• 商业依赖：TranscriptAPI 为第三方服务，长期稳定性、定价策略变更风险不可控
• 额度消耗：频道全量扫描（如 2000 视频频道需 20 次调用）快速消耗免费额度
• 无官方背书：非 Google/YouTube 官方 API，TOS 合规性需用户自行评估
• 速率限制：300 req/min 对高频监控场景可能吃紧

适合人群

• 内容创作者追踪竞品频道更新
• 研究者批量采集特定频道元数据
• 自动化工具开发者构建"关注列表"监控

常规风险

| 类型 | 说明 |

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

| API 密钥泄露 | `sk_` 前缀密钥需妥善保管，脚本中硬编码有暴露风险 |

| 服务中断 | 第三方 API 可能因 YouTube 反爬策略调整而失效 |

| 数据时效 | RSS 更新存在分钟级延迟，非实时流 |

| 合规边界 | 大规模自动化采集可能触发 YouTube ToS 第 4.C 条关于自动访问的限制 |

核心用法

youtube-channels 是一套基于 TranscriptAPI.com 的 YouTube 频道数据工具集，支持四大核心功能：

1. 频道解析 (/channel/resolve) — 免费：将 @handle、URL 或混合输入转换为标准 UC... 频道 ID
2. 最新视频 (/channel/latest) — 免费：获取频道最近 15 条上传，含精确播放数、评分、ISO 时间戳
3. 全量浏览 (/channel/videos) — 1 credit/页：分页拉取频道全部视频，每页 100 条，支持续传翻页
4. 频道内搜索 (/channel/search) — 1 credit：在指定频道内搜索关键词，支持结果数量限制

典型工作流：@handle → channel_id → latest videos → 选视频取字幕

显著优点

• 零依赖实现：Skill 本体仅使用 Node.js 内置模块，无供应链攻击风险
• 智能配置注入：一键完成 API Key 多平台部署（Agent 配置 + Shell RC + systemd + Fish），大幅降低用户配置成本
• 清晰的成本结构：resolve 和 latest 端点完全免费；付费端点按页/次计费，100 积分起送，300 req/min 限速透明
• 完整的参数校验：所有输入均带正则验证，错误码体系清晰（400/402/404/408/422）
• RSS 级实时性：latest 端点基于 RSS，视频上线即可抓取，适合监控场景

潜在缺点与局限性

• 完全依赖第三方服务：功能可用性、数据准确性、服务持续性完全绑定 TranscriptAPI.com，无降级或缓存机制
• 配置修改范围过广：自动注入会修改 ~/.bashrc、~/.zshenv、~/.profile、Fish 配置及 Windows PowerShell 配置，存在误改用户环境的风险
• T3 级来源风险：维护者为个人开发者，缺乏组织背书，长期维护能力存疑
• 隐私暴露面增大：API Key 存储位置多达 5-6 处，虽 ~/.transcriptapi 设 600 权限，但其他位置权限依赖系统默认
• Agent 配置直接修改：通过 save-key 直接注入 moltbot.json/openclaw.json，若写入过程中断可能导致配置损坏
• 临时邮箱黑名单有限：仅覆盖 8 个常见临时域名，反滥用机制不够完善

适合人群

• 内容创作者/研究员：需批量监控特定频道更新、做竞品分析或学术研究
• 自动化工作流搭建者：希望将 YouTube 频道数据接入 CI/CD、通知机器人或数据 pipeline
• 轻度技术用户：愿意用 100 免费积分验证需求，且能接受第三方 API 依赖

不适合：对数据主权敏感、要求离线可用、或无法接受个人开发者维护的生产环境用户。

常规风险

| 风险项 | 等级 | 说明 |

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

| 第三方服务中断 | 中 | 服务宕机或 API 变更将导致 Skill 完全失效 |

| 密钥泄露 | 中 | 多位置存储增加暴露面，建议定期轮换 |

| Shell 配置污染 | 中 | 自动修改 RC 文件可能引入意外变量或冲突 |

| 数据隐私 | 低-中 | 频道查询记录可能暴露用户兴趣画像 |

| 费用失控 | 低 | 免费额度充足，但需关注 credits 消耗，避免意外欠费 |

建议措施：使用专用 API Key（非主账号）、定期检查 ~/.transcriptapi 权限、在隔离环境测试后再部署生产。