用途:更新已认证 YouTube 频道中视频的标题和描述,以改善搜索与浏览可见性。这是该套件中唯一具备写入能力的技能,持有 youtube.force-ssl 写入凭证,可永久改写视频标题与描述。
主要能力:可编辑 snippet.title(≤100 字符,不含 < 或 >)和 snippet.description(≤5000 UTF-8 字节,不含 < 或 >);标签和 categoryId 会被保留并原样重发;不涉及隐私/发布状态、缩略图、播放列表、评论、删除或上传。每次写入前会完整备份原 snippet,revert 可恢复。
使用方式:先完成一次性设置,复用 youtube-channel-insights 的 Google Cloud 项目与 client_secret.json,并授予写入权限:pip3 install google-api-python-client google-auth-oauthlib 和 python3 scripts/auth_write.py。写入令牌单独存于 ~/.config/youtube-skills/token_write.json。常用命令包括:python3 scripts/auth_write.py --check 检查授权;python3 scripts/update_metadata.py list --limit 50 列出视频;get 查看当前状态;preview 生成预览;apply --plan ... --confirm 执行写入;revert --videos ID,ID --date YYYY-MM-DD --confirm 回滚。apply 不带 --confirm 为安全空跑。
适用场景:针对有留存但浏览量低的“包装问题”视频优化标题与描述;搜索流量为主的频道收益最大。
限制:API 不提供 CTR 和展示次数,需在 YouTube Studio 的 Reach 中查看;标题修改不重置观看数,但可能改变推荐测试;传播非即时;每次运行最多 50 次更新;videos.update 每次消耗 50 配额单位;仅限已认证频道;备份为本地文件;标签不会被优化。写入前必须展示预览表并获得用户明确批准。