终端管理 YouTube 的完整 CLI

终端直连 YouTube Data API v3，支持视频搜索/上传/播放列表管理，JSON 输出原生适配自动化工作流。

基本信息

• 技能名称?YouTube API CLI
• 中文名称?终端管理 YouTube 的完整 CLI
• 作者?nerveband
• 分类?专业技能
• 版本?1.0.2
• 标签?youtube, api-cli, automation, video-management, oauth, google-cloud

使用方法

使用说明
核心用法
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 频道权限，默认无访问权 |