YouTube Music 馆员
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-ytmusic-librarian
技能介绍
要解决什么问题
YouTube Music 没有面向个人脚本的官方 API,想批量整理「我的曲库」、改点赞状态、建歌单或拉歌词,往往只能反复点客户端。这个技能把 ytmusicapi 接到 Agent 工作流里,用 Python 侧封装好的方法替你读写账号数据,而不是让你自己拼 HTTP 或逆向页面逻辑。
技能如何工作
技能依赖技能目录下的鉴权文件(oauth.json 或 browser.json)。典型做法是:在已登录的浏览器里抓取 browse 请求的 cURL,经转换脚本生成 browser.json,之后 Agent 即可调用库接口。
核心能力分三块:
- 曲库管理:
yt.get_library_songs()、yt.get_library_albums()列出收藏;yt.rate_song(videoId, 'LIKE')、yt.edit_song_library_status(feedbackToken)调整曲目在库内的状态。 - 播放列表:
yt.create_playlist(title, description)建表;yt.add_playlist_items/yt.remove_playlist_items按videoId增删曲目。 - 元数据与发现:
yt.get_lyrics(browseId)取歌词;yt.get_watch_playlist(videoId)可拿相关推荐上下文。
适用边界与注意点
这是非官方接口封装,鉴权会随 Google/YouTube 调整而失效,cURL 握手步骤需要你能访问 music.youtube.com 并用 Edge 抓包。Agent 能替你编排调用,但不能替代你本地安装 ytmusicapi 和维护鉴权文件;批量操作时注意 API 限流与账号条款,避免高频自动化触发异常。
使用场景
- 整理 YouTube Music「库」里歌曲与专辑列表,导出给本地脚本做去重或归档
- 按一批 videoId 新建主题歌单,并把曲目批量加入或移出指定 playlistId
- 对已入库曲目调用 rate_song 或 edit_song_library_status,统一标记喜欢或移出库
- 根据 browseId 拉取歌词,或在分析某首歌时用 get_watch_playlist 查相关曲目
适合人员
- 用 Python 维护音乐数据、想把 YouTube Music 收藏同步进自建库的开发者
- 运营个人主题歌单、需要按曲目 ID 批量增删而非手点客户端的听众
- 做歌词/元数据小工具、要对接非官方 ytmusicapi 接口的脚本作者
- 已在 Agent 里跑自动化任务、愿意用浏览器 cURL 方式维护 browser.json 的工程师