音楽制御はSpotifyのみに制限
music-control
macOS上でKuGou MusicまたはSpotifyをCLIから制御します。ユーザーの作業セッションを音楽で強化するために、プロアクティブかつレスポンシブに動作します。
セットアップ
必要条件: macOS、Python 3.10以上、KuGou MusicまたはSpotifyのデスクトップアプリがインストール済み。
Spotify APIキーやOAuthの設定は不要 — 匿名のWeb Player APIを使用して検索します。
CLI
MUSIC="python3 ~/.claude/skills/music-control/scripts/music_cli.py"
$MUSIC [--provider kugou|spotify] <コマンド>
| コマンド | 説明 |
|---|---|
status | 現在のトラック情報（JSON） |
play | 再生/一時停止の切り替え |
next | 次のトラックへスキップ |
prev | 前のトラックへ戻る |
play-by <タイトル>... | 検索して即再生；複数曲は \(で区切る |
search <クエリ> [--page N] | ページネーション付き検索 |
recommend <ムード> | ムードに応じて選曲し再生 |
queue-show | 現在のキューを表示 |
queue-add <タイトル>... | キューに曲を追加；複数曲は \(で区切る |
queue-play [インデックス] | キューから再生開始 |
queue-next | キューの次の曲へスキップ |
queue-clear | キューをクリア |
--provider のデフォルトは spotify です。Spotifyが起動していない場合は自動で起動します。MUSIC_PROVIDER=kugou を設定するとKuGouを使用します。
ムードキーワード
| ムード | 使用する場面 |
|---|---|
focused | 深い集中作業、コーディング中のフロー、読書 |
relaxed | 気軽な雑談、休憩、軽いタスク |
hyped | 機能リリース、バグ修正完了、勝利 |
sad | ユーザーの愚痴、問題で行き詰まっているとき |
debug | イライラしている、厄介なバグを追跡中 |
プロアクティブトリガールール
常にユーザーから依頼されなくても、以下のシグナルを検出したらアクションを起こしてください:
| 会話中のシグナル | アクション |
|---|---|
| ユーザーが新しいコーディングセッションを開始 | recommend focused → トップ結果を再生 |
| ユーザーがバグ修正/リリース完了を発言 | recommend hyped → トップ結果を再生 |
| ユーザーがイライラ/行き詰まっている | recommend debug |
| ユーザーがリラックスしたいと発言 | recommend relaxed |
| ユーザーが特定の曲・アーティストに言及 | play-by <曲名> <アーティスト> |
| 会話中に長い沈黙/アイドル状態 | recommend relaxed |
| ユーザーが詳細なしで「何か流して」と依頼 | 最近の会話のムードから推測 |
キューと複数曲指定
複数曲の区切り文字: |||
$MUSIC play-by 逆战 ||| 天下 ||| 这就是爱
$MUSIC queue-add 逆战 ||| 天下
$MUSIC queue-play
$MUSIC queue-next
$MUSIC search 周杰伦 --page 2
レスポンス形式
{"ok": true, "title": "晴天", "artist": "周杰伦", "playing": true}
{"ok": true, "results": [{"title":"...", "artist":"...", "id":"..."}]}
{"ok": true, "action": "next"}
{"ok": true, "action": "queue_next", "current": 1, "has_next": true}
{"ok": false, "error": "no_player", "message": "..."}
注意事項
- Spotify: 匿名のWeb Player APIで検索 — ログインやAPIキーは不要
- KuGou: KuGou Music macOSアプリのインストールが必要
statusがno_playerを返した場合、アプリがまだ読み込み中の可能性があります — 3秒待って再試行してください- キューは
~/.config/music-cli/queue.jsonに永続化されます