Apple Music控制

技能简介

通过 AppleScript（macOS）或 MusicKit API 实现 Apple Music 的深度集成，支持本地音乐应用控制与云端服务调用两种模式。

能做什么

• 播放控制：播放、暂停、切歌、调节音量、设置循环与随机播放
• 歌单管理：创建、删除、重命名歌单，添加或移除曲目
• 曲库操作：搜索目录、将歌曲加入个人曲库、查看播放历史
• 设备切换：AirPlay 设备列表查询与切换
• 元数据读写：获取或修改歌曲评分、喜爱状态、流派、年份等信息

使用说明

安装要求

AppleScript 方式无需安装，macOS 系统自带；MusicKit API 需注册 Apple 开发者账号并配置令牌。

快速开始（AppleScript）

# 播放/暂停切换
osascript -e 'tell application "Music" to playpause'

# 获取当前播放曲目名称
osascript -e 'tell application "Music" to return name of current track'

# 多行脚本示例
osascript <<'EOF'
tell application "Music"
    set t to current track
    return {name of t, artist of t}
end tell
EOF

核心限制：曲库优先流程

歌曲必须先加入个人曲库，才能添加到歌单。目录 ID 无法直接写入歌单，需经「目录 ID → 曲库 → 歌单」的转换路径。

输入与输出

见下方输入与输出表格。

风险提示

• AppleScript 仅适用于 macOS，Windows/Linux 用户需改用 MusicKit API
• API 方式无法直接控制本地播放，仅限云端数据操作
• 曲库 ID 与目录 ID 混用会导致操作失败
• 批量修改元数据前建议备份曲库
• AirPlay 设备切换可能因网络延迟出现响应滞后

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/epheterson/mcp-applemusic/SKILL.md
来源类型：GitHub 仓库