Qiaomu Music Player Spotify

Qiaomu Music Player (Spotify)

用自然语言控制 Spotify 播放音乐的 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) Skill。

对 AI 说"来点爵士"、"适合下雨天的音乐"、"播放 Bohemian Rhapsody"，它就帮你搜、帮你放。

内置 5,947 个音乐风格数据库，AI 能根据你的描述精准匹配风格并推荐曲目。

纯 Python 标准库实现，零依赖，不需要 MCP Server。支持 Claude Code、Cursor、Codex 等 37+ AI 编程工具。

快速安装

# 方式一：npx 一键安装（推荐）
npx qiaomu-music-player-spotify

# 方式二：Vercel Skills CLI
npx skills add joeseesun/qiaomu-music-player-spotify

# 方式三：手动安装
git clone https://github.com/joeseesun/qiaomu-music-player-spotify.git ~/.claude/skills/qiaomu-music-player-spotify

安装后还需要配置 Spotify 凭证，详见下方 [安装教程](#安装教程保姆级)。

Features

• 完整播放控制：搜索、播放、暂停、下一首、音量、队列、随机、循环
• 批量播放：一次播多首，自动排队
• 5,947 个音乐风格：RateYourMusic 层级数据库（49 大类 > 737 子类 > 5,161 细分类）
• 30+ 风格快捷播放：说"听 Jazz"直接放，无需搜索
• 场景/心情推荐：模糊描述（"写代码的背景音乐"）→ AI 匹配风格 → 推荐具体曲目
• Token 自动刷新：OAuth 2.0 授权一次，之后自动续期
• 零依赖：纯 Python 标准库，不需要 pip install 任何东西

---

安装教程（保姆级）

Step 1: 准备 Spotify 账号

你需要一个 Spotify **Premium 账号**（免费账号部分功能受限）。

国内没有 Spotify 服务，推荐在淘宝搜"Spotify 会员"，大约 **150 元/年**，店家会帮你充值到你的 Spotify 账号上。如果没有账号，去 [spotify.com](https://www.spotify.com/) 先注册一个。

注册/登录后，下载安装 [Spotify 桌面客户端](https://www.spotify.com/sg-zh/download/other/)（选择你的操作系统），安装后登录并保持打开（播放音乐需要一个活跃设备）。

Step 2: 创建 Spotify Developer App

这一步是为了获取 API 凭证，让脚本能控制你的 Spotify。

1. 打开 Spotify Developer Dashboard
2. 用你的 Spotify 账号登录
3. 点击 Create App
4. 填写表单：
   • App name: 随便填，比如 My Music Player
   • App description: 随便填，比如 Personal music player
   • Redirect URIs: 填入 http://127.0.0.1:8888/callback，然后点 Add
   • APIs used: 勾选 Web API
5. 勾选同意条款，点 Save
6. 进入刚创建的 App，点 Settings
7. 你会看到：
   • Client ID — 直接显示，复制保存
   • Client Secret — 点 "View client secret" 后显示，复制保存

Step 3: 下载本项目

# 方式一：作为 Claude Code Skill 安装（推荐）
git clone https://github.com/joeseesun/qiaomu-music-player-spotify.git ~/.claude/skills/qiaomu-music-player-spotif