YouTube Music

核心用法

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 包含敏感会话信息，需严格保管
• 接口变动可能导致功能突然中断，需关注上游库更新

YTMusic Librarian：你的 YouTube Music 自动化管家

核心用法

YTMusic Librarian 是一个基于 ytmusicapi Python 库的纯文档型技能，旨在帮助用户通过结构化指令管理 YouTube Music 库。它涵盖了三大核心工作流：

所有操作均依赖用户事先手动完成基于浏览器的 cURL 认证设置，生成 browser.json 文件。

• 音乐库管理：列出或点赞/取消点赞库中的歌曲与专辑。
• 歌单管理：创建新歌单、添加或移除歌曲。
• 元数据与发现：获取歌词、查看相关推荐曲目。

显著优点

• 功能聚焦：精准锁定 YouTube Music 高频场景（管歌单、存歌曲），操作指令简洁明确。
• 透明可控：基于成熟的 ytmusicapi 开源库，代码逻辑完全由 Python 脚本运行，不涉及黑箱 AI 决策。
• 零依赖风险：技能本身为纯文档，无第三方依赖包、无可执行代码，几乎不存在供应链攻击面。
• 官方生态：仅与 music.youtube.com 可信域名交互，网络连接安全。

潜在缺点与局限性

• 认证繁琐：要求用户手动从浏览器 DevTools 复制包含 Cookie 的 cURL 命令，对于非技术用户来说门槛较高。
• 安全凭证暴露风险：headers.txt 和 browser.json 含有完整的账户认证信息，若未加入 .gitignore 或处理不当，极易泄露账户权限。
• 来源不透明：来自未知内部平台（T3 信任等级），缺少开源许可证、公开仓库和明确维护者，无法验证代码出处和后续维护承诺。
• 无 Agent 自执行能力：作为纯文档型 Skill，它只能提供操作指南，无法被 AI Agent 自动解析并调用执行，需要用户手动在命令行运行 Python 命令。

适合的目标群体

• YouTube Music 重度用户：需要批量整理大量歌单、快速点赞或归档歌曲的用户。
• 本地音乐自动化玩家：希望将 YouTube Music 纳入自己脚本工具链的技术爱好者，可在此基础上二次开发。
• 偏好手动控制的技术用户：愿意处理认证配置、运行 Python 脚本，对自动化有精确控制需求的用户。

使用可能存在的常规风险

• 账户安全风险：browser.json 等同于登录凭证，一旦泄露，他人可完全操作你的 YouTube Music 库。认证文件必须严格本地保管。
• 服务条款风险：YouTube 未公开提供操作音乐库的官方 API，ytmusicapi 通过逆向工程客户端接口工作，存在违反 YouTube 服务条款的可能，极端情况下可能导致账户功能受限。
• 兼容性中断风险：由于依赖非官方 API，YouTube Music 客户端任何微小的前端改动都可能导致 ytmusicapi 失效，需要等待库更新。
• 维护未知风险：T3 来源意味着该 Skill 可能随时停止更新，缺少公开 Issue 通道，未来遇到问题无处求助。

总结：YTMusic Librarian 是一个上手门槛中等、功能单一但精准的 YouTube Music 辅助技能。它能显著提升歌单管理效率，但用户必须充分评估凭证安全、服务条款风险以及来源可信度，建议仅作为个人工具在有经验的用户环境中使用。