核心用法
YTMusic Librarian 是一个围绕 ytmusicapi Python 库构建的技能,提供对 YouTube Music 的编程化访问能力。核心功能涵盖三大模块:
1. 媒体库管理
get_library_songs()/get_library_albums()获取个人曲库rate_song()点赞/点踩,edit_song_library_status()修改保存状态
2. 播放列表操作
- 创建、添加/移除曲目,完整支持歌单生命周期管理
- 通过
videoId精确操作,适合批量整理
3. 发现与元数据
get_lyrics()获取歌词,get_watch_playlist()探索关联推荐
显著优点
- 功能全面:覆盖官方客户端大部分核心能力
- 免费访问:无需 YouTube Music Premium 即可操作个人库
- 可编程性:适合自动化整理、迁移歌单等脚本场景
潜在局限与风险
- 非官方 API:
ytmusicapi通过逆向工程实现,Google 随时可能变更接口导致失效 - 认证繁琐:需手动从浏览器 DevTools 复制 cURL 请求头,门槛较高且易过期(需定期重新抓取)
- 无 OAuth 原生支持:当前方案依赖浏览器 cookies,安全性与稳定性弱于官方 OAuth
- ToS 灰色地带:违反 YouTube Terms of Service 第 4 条关于自动化工具的规定
适合人群
技术用户、音乐数据整理爱好者、需要跨平台歌单迁移的进阶用户。不适合追求开箱即用的普通听众。
常规风险
- 账号可能因异常请求模式被限速或封禁
- 认证文件
browser.json包含敏感会话信息,需严格保管 - 接口变动可能导致功能突然中断,需关注上游库更新