名称： apple-music
描述： 搜索 Apple Music，添加歌曲到资料库，管理播放列表，控制播放与 AirPlay。
元数据： {"clawdbot":{"emoji":"🎵","os":["darwin"],"requires":{"bins":["node","curl"]}}}

Apple Music

通过 MusicKit API 和 AppleScript 控制 Apple Music。路径：~/.clawdbot/skills/apple-music/

本地使用（无需配置）

播放控制： ./apple-music.sh player [now|play|pause|toggle|next|prev|shuffle|repeat|volume N|song "名称"]
AirPlay： ./apple-music.sh airplay [list|select N|add N|remove N]

API 使用（需配置）

需要 Apple 开发者账户（$99/年）和 MusicKit 密钥。

配置步骤

先在开发者门户操作：
1. 访问 developer.apple.com → Keys → 创建 MusicKit 密钥 → 下载 .p8 文件
2. 记录你的 Key ID 和 Team ID

然后运行配置脚本：

./launch-setup.sh  # 在终端中打开交互式配置界面

启动器会打开 Terminal.app 并在其中运行配置脚本。输入你的 .p8 文件路径、Key ID、Team ID，然后在浏览器中授权并粘贴返回的令牌。

⚠️ 代理注意： 始终使用 ./launch-setup.sh 在终端中打开配置。切勿通过聊天界面直接运行 setup.sh（需要交互式输入）。

可用命令

• search "查询词" [--type songs|albums|artists] [--limit N]
• library add <歌曲ID>
• playlists [list|create "名称"|add <播放列表ID> <歌曲ID>]

配置文件

config.json 存储令牌（有效期约 6 个月）。若认证失败，请重新运行 ./setup.sh。

常见错误

• 401：令牌已过期，请重新运行配置
• 403：请检查 Apple Music 订阅状态
• 404：ID 无效或内容受地区限制

配置问题排查

• 授权页面返回 404： 配置脚本会自动通过 HTTP 服务器验证进行修复
• 浏览器未显示令牌： 重启 setup.sh
• 浏览器无法自动打开： 手动复制打印的 URL 到浏览器（推荐使用 Chrome）