yt-api-cli 是一个专为命令行环境设计的 YouTube Data API v3 完整命令行接口工具，旨在让用户能够直接在终端中高效管理自己的 YouTube 账户。该工具通过 Go 语言开发，支持从基础的账户信息查询到复杂的视频上传、播放列表管理等高级操作，覆盖 YouTube 数据 API 的绝大多数功能。其设计初衷是简化自动化流程，尤其适合开发者、内容创作者以及需要批量处理 YouTube 内容的运维人员使用。默认输出格式为 JSON，便于与脚本、AI 模型或其他自动化系统无缝集成，同时支持多种人类可读格式如表格、YAML 和 CSV，满足不同场景下的展示需求。 该工具的安装方式灵活，既可通过 `go install` 直接安装，也可从 GitHub Releases 下载预编译的二进制文件。配置过程清晰明了：用户需在 Google Cloud Console 中启用 YouTube Data API v3 并创建 OAuth 2.0 客户端凭证，然后将相关信息填入本地配置文件（默认为 `~/.yt-api/config.yaml`）。认证支持 OAuth 2.0（交互式登录）和服务账户两种模式，分别适用于个人使用和服务器端自动化任务。所有敏感令牌均安全存储于本地，权限严格限制，确保账户安全。 yt-api-cli 强调对错误处理的友好性，采用结构化 JSON 输出错误信息，并提供明确的退出代码（如 0 表示成功，1-4 对应不同类型错误），极大提升了其在 CI/CD 或脚本中的可靠性。此外，工具内置诊断命令（如 `yt-api info` 和 `yt-api auth status`）可快速验证连接状态与权限范围，帮助用户排查常见问题。整体而言，这是一个高度可定制、稳定且易于集成的命令行工具，专为追求效率与自动化的现代开发者打造。
核心功能特点
- 完整的 YouTube Data API v3 CLI 实现，支持所有核心资源操作
- 默认 JSON 输出格式，优化用于 LLM 和自动化脚本解析
- 支持 OAuth 2.0 与服务账户双重认证机制
- 多格式输出选项：JSON、YAML、CSV、表格（human-readable）
- 内置诊断命令与错误处理，提供清晰的退出码与结构化报错
- 支持视频上传、播放列表管理、频道更新等高级功能
适用场景
yt-api-cli 特别适合那些希望在无需打开浏览器的情况下，通过脚本或命令行批量操作 YouTube 内容的开发者与内容团队。例如，一个技术博主可以编写自动化脚本定期上传最新教程视频，并通过 `–dry-run` 参数预先验证元数据设置是否正确；而运营团队则可利用其列出频道下所有视频并按播放量排序的功能，快速生成月度内容报告。对于 DevOps 工程师而言，该工具可在 CI/CD 流水线中调用，实现自动发布、监控配额使用情况或同步播放列表至其他平台，显著减少人工干预。 另一个典型应用场景是内容聚合与分析。研究人员或数据分析师可以通过搜索特定关键词的视频，结合 `–type video –duration medium –order viewCount` 等过滤条件，获取高质量样本数据，并将结果导出为 CSV 文件进行进一步处理。此外，企业内负责社交媒体管理的员工也能利用此工具统一管理多个频道的信息，比如批量更新频道描述、添加视频到指定播放列表，从而提升团队协作效率。由于支持 stdin 输入和标准错误抑制（`–quiet`），它还能轻松嵌入现有 shell 脚本生态系统中，与其他工具链（如 jq、awk、grep）协同工作，构建复杂的内容处理管道。