Metadata

name: spotify-claw
description: Full Spotify Premium control + music analysis. Playback: play/pause/next/prev/volume/shuffle/queue. Analysis: top tracks, top artists, liked songs, genre profile, taste breakdown. Discovery: find similar artists & music without Recommendations API. Playlist builder: make-playlist, liked-by-artist, discover. Auto-launches Spotify if closed. Credentials via macOS Keychain. Triggers: play music, pause, next track, what's playing, top tracks, playlist, genres, similar music, open spotify.
homepage: https://github.com/mixx85/spotify-claw
metadata: {"openclaw":{"emoji":"🎵","requires":{"bins":[]},"install":[{"id":"pip","kind":"pip","package":"spotipy","label":"Install spotipy (pip)"}]}}

spotify-claw

Full Spotify Premium control with music analysis and smart discovery.

ALWAYS run python3 ~/.openclaw/scripts/spotify.py [cmd] — never respond with text only.

✨ What makes this different

Feature	This skill	Basic Spotify skills
Playback control	✅ play/pause/next/prev/volume/shuffle/queue	✅
Auto-launch Spotify	✅ opens app if closed, waits, then plays	❌
Music taste analysis	✅ top tracks/artists across 3 time periods	❌
Genre profile	✅ full genre breakdown	❌
Music discovery	✅ works without blocked recommendations API	❌
Liked tracks analysis	✅ search, filter by artist	❌
One-command playlists	✅ creates + fills playlist in one command	❌
Multi-language triggers	✅ English + Russian	❌

Setup (first time)

Create app at developer.spotify.com/dashboard — Add redirect URI: http://127.0.0.1:8888/callback
Add to macOS Keychain:

security add-generic-password -a openclaw -s openclaw.spotify.client_id -w "CLIENT_ID"
security add-generic-password -a openclaw -s openclaw.spotify.client_secret -w "CLIENT_SECRET"

First auth — run now, browser opens, log in once:

python3 ~/.openclaw/scripts/spotify.py now

Playback Commands

python3 ~/.openclaw/scripts/spotify.py play                          # resume
python3 ~/.openclaw/scripts/spotify.py play "track name"             # search & play
python3 ~/.openclaw/scripts/spotify.py play spotify:track:URI        # by URI
python3 ~/.openclaw/scripts/spotify.py play spotify:playlist:ID      # playlist
python3 ~/.openclaw/scripts/spotify.py pause
python3 ~/.openclaw/scripts/spotify.py next
python3 ~/.openclaw/scripts/spotify.py prev
python3 ~/.openclaw/scripts/spotify.py volume 70
python3 ~/.openclaw/scripts/spotify.py volume up
python3 ~/.openclaw/scripts/spotify.py volume down
python3 ~/.openclaw/scripts/spotify.py shuffle on
python3 ~/.openclaw/scripts/spotify.py shuffle off
python3 ~/.openclaw/scripts/spotify.py queue "track name"
python3 ~/.openclaw/scripts/spotify.py now
python3 ~/.openclaw/scripts/spotify.py devices

Auto-launch: If Spotify is closed, play opens the app automatically, waits for init, then plays.

Analysis Commands

python3 ~/.openclaw/scripts/spotify.py top-tracks [short|medium|long] [limit]
python3 ~/.openclaw/scripts/spotify.py top-artists [short|medium|long] [limit]
python3 ~/.openclaw/scripts/spotify.py recent [limit]
python3 ~/.openclaw/scripts/spotify.py liked [limit]
python3 ~/.openclaw/scripts/spotify.py liked-all
python3 ~/.openclaw/scripts/spotify.py liked-by-artist "Artist Name"
python3 ~/.openclaw/scripts/spotify.py genres [short|medium|long]
python3 ~/.openclaw/scripts/spotify.py playlists
python3 ~/.openclaw/scripts/spotify.py search "query" [track|artist|album] [limit]
python3 ~/.openclaw/scripts/spotify.py track-info URI

Periods: short = 4 weeks · medium = 6 months · long = all time

Discovery & Playlist Builder

# Find new music by genre profile
python3 ~/.openclaw/scripts/spotify.py discover

# Expand from specific artist (depth=hops, n=tracks per artist)
python3 ~/.openclaw/scripts/spotify.py discover "Portishead" 3 3

# Related artists
python3 ~/.openclaw/scripts/spotify.py related-artists "The Cure" 10

# Top tracks of any artist
python3 ~/.openclaw/scripts/spotify.py artist-top-tracks "Massive Attack" 5

# Create playlist from top tracks (one command: creates + fills)
python3 ~/.openclaw/scripts/spotify.py make-playlist "Top March 2026" short 20

# Manage playlists
python3 ~/.openclaw/scripts/spotify.py create-playlist "My Playlist" "Description"
python3 ~/.openclaw/scripts/spotify.py add-to-playlist PLAYLIST_ID URI1 URI2

Note: Spotify's recommendations and audio_features APIs are blocked for new developer apps (return 403/404). This skill uses related_artists + artist_top_tracks for discovery instead.

Agent Tips

Use playlists to list user's playlists with IDs before playing one
Use now to confirm what's playing after a play command
Use liked-by-artist to find tracks for a themed playlist
Chain: related-artists → artist-top-tracks → add-to-playlist for smart playlist building
genres long gives the most accurate taste profile

Spotify

安装技能