核心用法
YTMusic Librarian 通过 ytmusicapi Python 库与 YouTube Music 服务端通信,提供完整的音乐库管理功能。核心能力分为三大模块:
曲库管理:获取用户的歌曲/专辑库列表(get_library_songs、get_library_albums),支持点赞歌曲(rate_song)及修改入库状态(edit_song_library_status)。
歌单操作:创建歌单(create_playlist)、批量添加/删除曲目(add_playlist_items、remove_playlist_items),满足日常歌单维护需求。
发现与元数据:获取歌词(get_lyrics)、探索相关推荐(get_watch_playlist),辅助音乐发现。
显著优点
- 功能覆盖全:相比官方有限的公开 API,实现了 YouTube Music 网页端的绝大部分交互能力
- 免费无广告:直接调用服务端接口,绕过客户端广告
- 灵活可编程:Python 接口便于自动化脚本和批量操作
局限性与风险
- 非官方逆向工程:
ytmusicapi通过逆向 YouTube Music 网页版实现,无 Google 官方支持,接口可能随时变更 - 繁琐的认证流程:需手动从浏览器 DevTools 提取 cURL 请求头,对普通用户门槛较高
- 账号安全风险:使用用户真实会话凭证,存在被判定为"异常登录"的可能
- 无实时同步:不保证与官方客户端状态即时同步
适合人群
- 熟悉 Python 的技术用户
- 需要批量管理 YouTube Music 曲库的高级玩家
- 希望自动化歌单维护的开发者
常规风险提示
| 风险项 | 说明 |
|--------|------|
| TOS 违规 | 违反 YouTube Terms of Service 第 3 节(禁止逆向工程)|
| 账号受限 | 异常请求模式可能触发安全验证或临时限制 |
| 数据泄露 | `browser.json` 包含有效会话,需严格保管 |