用途
connect-youtube-developer-platform 是一个用于把用户自己的 YouTube 频道接入智能体的技能。它使用用户本人的 Google 开发者账号,通过一个小型 CLI 与 YouTube API 交互,因此每次调用都占用用户自己 Google Cloud 项目的免费每日配额(10,000 单位),不经过任何第三方服务。
主要能力
连接完成后的 youtube-cli 提供以下命令(通过 python3 ~/.agents/skills/youtube-cli/scripts/youtube.py <command> 调用,不带命令可查看全部):
- 频道统计:channel
- 最新视频:videos --max 10;单个视频:video <id>
- 分析数据:analytics --days 28(逐日);表现最佳视频:top --days 28
- 评论:comments [videoId];回复:reply <commentId> "<text>" --yes
- 修改视频:update <videoId> --title ".." --description ".." --yes
- 上传(默认私密):upload <file> --title ".." --yes
- 配额剩余与开销:quota;其他接口:api GET /<path> --query k=v
配额为每天 10,000 单位,太平洋时间午夜重置;读取消耗 1,搜索 100,回复或更新 50,上传消耗更多。写操作前应先读取,并在执行 reply、update、upload、delete 前把确切文本给用户确认后再加 --yes。
使用方式
技能会在 Chrome AI 中自动完成 Google Cloud 侧的配置:检查 chrome-ai、dev-browser 与 Python 3.9+ 环境;确认目标 Google 账号与频道;查找或创建名为 YouTube CLI 的 Google Cloud 项目;开启 youtube.googleapis.com 与 youtubeanalytics.googleapis.com;配置 OAuth 同意屏幕并将应用发布,以避免测试状态每 7 天丢失授权;创建桌面应用类型的凭据并安全保存(不打印、不记录密钥)。随后安装 CLI 到 ~/.agents/skills/youtube-cli/,运行授权脚本,用户在 Chrome AI 窗口中选择账号、在“Google 尚未验证此应用”页面点击继续并勾选所需权限。最后用 channel、videos、analytics 等真实读取验证连通性,并写入 SKILL.md 供后续会话使用。
用户只需登录、选择频道并点击“允许”。若从链接获取该技能而非本地文件夹,可用 curl 下载 scripts/youtube.py 与 scripts/youtube-oauth.sh;不要从仓库安装其他内容。
适用场景
适合需要让智能体查看自己频道的视频表现、找出最佳视频、读取或回复评论、修改标题描述、上传视频的用户。若用户的 brain 文件夹中有 AGENTS.md,可加入一行说明 YouTube 相关操作走 /youtube-cli。
限制
密钥只在创建时显示一次;不得打印、记录或复述密钥、登录码及配置文件内容。接受 Google Cloud 条款和发布应用前需征得用户同意。授权脚本退出码 4 表示超时未授权,退出码 5 表示无持久访问,需在 Google 权限页面移除应用后重试。全新频道的分析数据可能为空。若 Google 提示 API 未开启,需重新执行开启步骤。该技能依赖 Chrome AI 与 dev-browser 环境,且需要 Python 3.9 或更新版本。