核心用法
youtube Skill 提供对 YouTube Data API v3 的托管代理访问，通过 Maton 官方网关实现 OAuth 认证托管，用户无需自行申请 Google Cloud 项目和配置 OAuth 流程。
主要功能模块
| 模块 | 核心能力 | 典型场景 |
|------|---------|---------|
| **搜索** | 视频/频道/播放列表搜索，支持多维度过滤（发布时间、时长、排序） | 内容发现、趋势分析 |
| **视频** | 获取详情、统计数据、点赞、热门趋势 | 数据监控、竞品分析 |
| **频道** | 频道信息查询、我的频道数据 | 创作者管理、KOL 分析 |
| **播放列表** | CRUD 完整操作、批量管理视频 | 内容聚合、课程管理 |
| **订阅** | 订阅列表查询、订阅/取消订阅 | 用户画像、社交分析 |
| **评论** | 评论读取、发布、回复、删除 | 互动管理、舆情监控 |
认证流程
1. 获取 Maton API Key（注册 maton.ai）
2. 创建 YouTube 连接（ctrl.maton.ai/connections）
3. 浏览器完成 Google OAuth 授权
4. 通过 gateway.maton.ai/youtube/* 发起 API 调用
---
显著优点
1. 零 OAuth 基础设施成本 — 无需 Google Cloud Console 配置、无需处理 OAuth 回调和令牌刷新
2. 原生 API 完整覆盖 — 代理层保持 YouTube Data API 原生语义，官方文档可直接参考
3. 多连接管理 — 支持多账号切换，适合 MCN 机构或代运营场景
4. 企业级安全架构 — Maton 作为 T2 级可信商业实体，提供托管令牌存储和 HTTPS 全链路加密
---
局限性与风险
功能限制
- 配额瓶颈：YouTube API 本身有每日配额限制（搜索消耗 100 单位/次，读取仅 1 单位）
- 写入门槛：部分写操作（如评论、订阅）需要频道验证，可能触发人工审核
- 速率限制：Maton 网关限流 10 req/s/账号，高并发场景需设计重试策略
供应商锁定
- 完全依赖 Maton 网关可用性（gateway.maton.ai, ctrl.maton.ai）
- 若 Maton 服务中断或策略变更，需迁移至原生 YouTube API
隐私合规
- 通过 Maton 代理转发，需额外信任 Maton 的数据处理合规性
- OAuth 授权范围较大（默认获取完整 YouTube 权限），无法精细化 scope 控制
---
适合人群
- 内容创作者/团队：批量管理视频、播放列表，监控频道数据
- 数据分析师：无需运维 OAuth 即可抓取公开 YouTube 数据
- 教育/媒体机构：课程播放列表管理、内容聚合应用开发
- 快速原型开发：24 小时内完成 YouTube 集成验证
---
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 密钥泄露 | 中 | MATON_API_KEY 泄露可导致账号被滥用，需按环境变量安全规范存储 |
| OAuth 会话过期 | 低 | 连接可能因 Google 安全策略失效，需监控状态并引导重新授权 |
| 配额超限 | 中 | 高频搜索易耗尽配额，建议缓存结果、优先使用视频/频道读取接口 |
| 隐私合规争议 | 低 | 抓取用户生成内容需遵守 YouTube ToS 和当地数据法规 |