核心用法
yt-api-cli 是围绕 Google YouTube Data API v3 构建的完整 CLI 工具，采用 Go 语言开发，支持跨平台部署（Darwin/Linux）。核心功能覆盖四大场景：
内容管理：视频上传（含缩略图）、标题/描述/标签编辑、隐私设置调整；频道运营：频道信息查询、订阅列表管理、品牌账户切换；播放列表：创建、编辑、排序、批量添加/移除视频；数据检索：支持复杂过滤的视频搜索（按时长、排序、发布日期）、评论管理、数据分析统计。
输出格式专为自动化设计——JSON 为默认格式，同时支持 YAML、CSV、Table 三种人类可读格式。环境变量与配置文件双轨配置，支持 OAuth 2.0（交互式）和 Service Account（服务器自动化）两种认证模式。
显著优点
- API 原生对齐：完全映射 YouTube Data API v3 资源模型，无功能阉割
- LLM 优先设计：JSON 默认输出、结构化错误对象、
--dry-run验证模式，天然适配自动化脚本和 AI agent 集成 - 企业级认证：支持 OAuth 刷新令牌持久化和 Service Account 无头部署
- 诊断完备：内置连通性测试、权限校验、配额状态检查
潜在局限
- 配额约束：受 YouTube API 每日配额限制（默认 10,000 units），大规模批量操作需申请提升
- 非官方工具：由个人开发者（nerveband）维护，非 Google 官方项目，长期支持存在不确定性
- OAuth 流程依赖：首次配置需浏览器交互，纯 SSH 环境需预置 Service Account
- 功能边界：不包含视频下载（违反 ToS）、直播控制、YouTube Studio 专属功能
适合人群
内容创作者自动化工作流、MCN 机构批量管理、开发者构建 YouTube 集成工具、数据分析师提取公开视频元数据。
常规风险
- 凭证泄露：OAuth client secret 和 Service Account JSON 需严格保密，误提交至版本控制将导致账户接管
- API 滥用：自动化评论/订阅操作可能触发 YouTube 反垃圾机制，导致 API 权限收回或频道封禁
- 配额耗尽：未监控 quota usage 可能导致生产服务中断
- 令牌过期：OAuth refresh token 可能因用户改密或范围变更而失效，需设计容错重连机制