YouTube命令行工具

技能简介

yt-api-cli 是一款面向 YouTube Data API v3 的完整命令行客户端，支持在终端完成视频列表查询、搜索、上传、播放列表管理及频道信息更新等操作。

业务背景

运营与技术团队可直接在终端完成 YouTube 内容的全生命周期管理，无需打开网页后台。支持批量查询、格式导出及自动化脚本集成，适合需要频繁操作或对接内部系统的场景。

落地案例：某 MCN 机构每日需将签约创作者的新视频归档至内部 CMS。通过命令行工具执行视频列表查询，输出 CSV 格式的视频 ID、标题、播放量数据；上传新视频时直接在终端设置隐私状态、标签和缩略图，无需切换多个界面。

能做什么

• 列出个人或指定频道的视频、播放列表、订阅内容
• 按关键词搜索视频，支持时长、排序等过滤条件
• 上传视频及缩略图，设置标题、描述、标签和隐私状态
• 创建播放列表并向其中添加视频
• 获取和更新频道基本信息与统计数据
• 输出 JSON、YAML、CSV、表格等多种格式

使用说明

安装

# 使用 go install
go install github.com/nerveband/youtube-api-cli/cmd/yt-api@latest

# 或下载预编译二进制
curl -L -o yt-api https://github.com/nerveband/youtube-api-cli/releases/latest/download/yt-api-darwin-arm64
chmod +x yt-api
sudo mv yt-api /usr/local/bin/

配置与认证

1. 前往 Google Cloud Console 启用 YouTube Data API v3，创建 OAuth 2.0 桌面应用凭证并下载配置
2. 创建配置文件 ~/.yt-api/config.yaml，填入 client_id 和 client_secret
3. 执行 yt-api auth login 完成浏览器授权

常用命令示例

# 列出个人视频
yt-api list videos --mine

# 搜索视频
yt-api search --query "golang tutorial" --type video

# 上传视频
yt-api upload video ./video.mp4 --title "My Video" --privacy public

# 创建播放列表
yt-api insert playlist --title "My Playlist" --privacy private

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管 OAuth 凭证，避免 client_secret 泄露
• API 存在调用配额限制，频繁操作可能触发限流
• 服务账号权限受限，无法访问用户私人数据如”稍后观看”
• 令牌文件存储于本地，注意文件权限设置为 0600

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nerveband/yt-api-cli/SKILL.md
来源类型：GitHub 仓库