核心用法
MaxHub YouTube Skill 通过统一的 REST API 接口（https://www.aconfig.cn）提供 YouTube 平台全量数据查询能力。用户配置 MAXHUB_API_KEY 后即可通过 HTTP GET 请求访问 37 个白名单端点，覆盖四大核心领域：
- 视频数据：视频详情、播放流（Streams）、多语言字幕（Captions）、相关推荐、趋势榜单
- 频道画像：频道资料、长视频列表、Shorts 短视频、社区帖子、ID/URL 互转
- 搜索能力：综合搜索、Shorts 专项搜索、频道搜索、搜索建议词
- 评论分析：视频评论与回复、社区帖子评论与回复
支持 Web / Web V2 双版本接口并行，V2 版本字段更丰富（如 need_format、language_code），且字幕接口可直接通过 video_id 获取，无需预先获取字幕 URL。调用遵循"recipes_first"原则：优先匹配预设链路（Recipe），无匹配时再原子化组装。
显著优点
1. 全维度覆盖：单 Skill 覆盖 YouTube 生态核心数据层，无需多工具切换
2. 双版本降级：主链路异常时自动降级到备用接口版本，保障可用性
3. 零依赖部署：仅需 curl 和 API Key，无第三方库依赖
4. 精细化风控：按风险等级分级自检（low/medium/high/critical），low 风险端点仅校验路径即可调用
5. 字段流透明：param-mappings.md 明确定义跨端点参数传递规则，杜绝 Agent 臆造 JSON Path
潜在缺点与局限性
- 第三方依赖：所有数据流经 MaxHub 服务器（
aconfig.cn），非直连 YouTube 官方 API - 速率与配额：未公开速率限制细节，大规模采集需关注配额消耗
- 地域合规：用户需自行确保符合《个人信息保护法》、GDPR 及 YouTube ToS
- 数据时效：非实时流数据，存在缓存延迟
- 只读限制：无法执行点赞、订阅、上传等写操作
适合人群
- YouTube 内容创作者与频道运营（选题分析、爆款规律提炼）
- 跨境短视频研究者（Shorts 选品、竞品监控）
- MCN 与增长团队（频道 360° 画像、观众结构分析）
- 知识博主与二创团队（多语言字幕批量采集、翻译素材库构建）
- 数据分析师与学术研究者（UGC 内容语料采集）
常规风险
| 风险类型 | 说明 |
|---------|------|
| 凭证泄露 | API Key 需妥善保管，禁止写入日志或对话 |
| 隐私合规 | 拉取的评论、帖子可能含个人信息，禁止未授权公开或入库 |
| 账号关联 | 建议配合独立测试账号使用，避免主力账号凭证泄露 |
| 版权风险 | 播放流 URL 与字幕内容需遵守平台版权规则 |
| 服务可用性 | 依赖 MaxHub 服务稳定性，建议实现本地缓存与降级策略 |
安全评估
本 Skill 设计为只读（read-only）模式，无写入或账户操作能力。所有端点均经 endpoints_whitelist.yaml 硬校验，禁止路径臆造。敏感凭证通过环境变量隔离，网络传输采用 HTTPS。风险等级评估为 Low，适合自动化场景部署。