YouTube API CLI

核心用法

yt-api-cli 是一款面向开发者和自动化场景设计的 YouTube Data API v3 完整命令行工具，用 Go 编写，支持跨平台（Darwin/Linux）。核心能力覆盖：

• 内容检索：搜索公开视频、列出频道/我的视频/订阅/播放列表，支持多维度过滤（类型、时长、排序）
• 内容管理：视频上传、缩略图上传、播放列表创建与编辑、频道信息更新
• 认证体系：OAuth 2.0（交互式，默认）与 Service Account（服务端自动化）双模式
• 输出格式：JSON（默认，LLM 友好）、Table、YAML、CSV，stdin/stdout 全管道支持

显著优点

1. 自动化原生设计：JSON 默认输出、结构化错误、--quiet 静默模式、--dry-run 预检，专为脚本和 LLM 集成优化
2. 完整 API 覆盖：非只读工具，支持写入操作（上传、修改元数据、管理播放列表）
3. 诊断体系完善：内置连通性测试、权限检查、认证状态查询，便于故障排查
4. Go 生态交付：单二进制文件，无运行时依赖，go install 一键安装

潜在局限与风险

• API 配额敏感：YouTube Data API v3 有严格的每日配额限制（默认 10,000 units），高频操作或批量上传易触顶
• OAuth 令牌本地存储：令牌持久化至 ~/.yt-api/tokens.json，依赖文件系统权限（0600），多用户环境需额外隔离
• 非 Google 官方出品：社区维护项目（nerveband），长期支持节奏不确定
• 写入操作不可逆：删除/更新操作无二次确认，脚本需自行实现幂等和备份逻辑

适合人群

• 需批量管理 YouTube 内容的创作者/MCN 技术团队
• 构建内容监控、自动上传管道的 DevOps/自动化工程师
• 在 AI 工作流中集成 YouTube 数据检索的 LLM 应用开发者

常规风险

| 风险点 | 说明 |

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

| 凭证泄露 | Client ID/Secret 需通过环境变量或配置文件注入，硬编码有泄露风险 |

| 配额耗尽 | 生产环境必须实施配额监控和退避策略 |

| 权限边界 | Service Account 需显式配置 YouTube 频道权限，默认无访问权 |

核心用法

yt-api-cli 是一款面向命令行用户的 YouTube Data API v3 完整客户端，通过 CLI 实现账号管理、内容上传和数据分析。

安装与认证：支持 go install 源码安装或预编译二进制下载。首次使用需在 Google Cloud Console 创建 OAuth 2.0 凭证，执行 yt-api auth login 完成浏览器授权流程。凭证存储于 ~/.yt-api/tokens.json，权限 0600。

核心功能模块：

• 内容管理：视频上传（含元数据/标签/缩略图）、播放列表创建与编辑、订阅管理
• 数据检索：视频搜索（支持多维度过滤）、频道统计、播放列表内容导出
• 输出格式：JSON（默认，LLM 友好）、Table、YAML、CSV，支持管道与自动化脚本集成
• 诊断工具：连通性测试、权限验证、系统状态检查

显著优点：
1. 自动化友好：JSON 默认输出、结构化错误、退出码分级、stdin/stdin 管道支持
2. 多认证模式：OAuth 2.0 交互式/服务账号服务端双模式
3. 零运行时依赖：Go 编译的单二进制文件，跨平台支持

潜在局限性：

• 依赖 Google Cloud 配额，高频操作可能触发 API 限流
• 服务账号权限受限，部分用户级操作需 OAuth
• 纯 CLI 无 GUI，对非技术用户门槛较高

适合人群：开发者、内容创作者自动化工作流、数据分析师、DevOps 运维人员

常规风险：

• OAuth 凭证泄露风险（需严格保护 ~/.yt-api/ 目录权限）
• API 配额耗尽导致服务中断
• 误操作批量删除/修改内容（建议配合 --dry-run 验证）