spotify-claw_skill

Overview

This skill provides full Spotify Premium control plus deep music analysis and discovery tools. It controls playback, inspects your listening profile, and builds playlists programmatically. Credentials are stored in macOS Keychain and the tool auto-launches Spotify when needed.

How this skill works

The skill runs as a local Python script that talks to the Spotify Web API and the Spotify desktop app. It issues playback commands, fetches top tracks/artists/liked songs, analyzes genre and taste breakdowns, and discovers similar music using related-artists and artist-top-tracks endpoints. Playlist creation and population are automated, and credentials are retrieved from macOS Keychain for secure access.

When to use it

• Quickly control playback from scripts or voice triggers (play, pause, next, prev, volume, shuffle).
• Audit listening habits with top tracks, top artists, recent plays, and genre profile.
• Build themed playlists from liked tracks, artist expansions, or discovery runs.
• Find similar artists and expand a seed artist without relying on the Recommendations API.
• Automate playlist generation and batch-add tracks to playlists.

Best practices

• Run commands through the provided python script (python3 ~/.openclaw/scripts/spotify.py [cmd]) so the tool can handle auth and app launching.
• Store your client ID and secret in macOS Keychain as described so tokens are secure and refreshable.
• Use period flags (short/medium/long) to adjust analysis scope: short=4 weeks, medium=6 months, long=all time.
• List playlists first to get playlist IDs before attempting playback or adding tracks.
• Chain discovery commands (related-artists → artist-top-tracks → add-to-playlist) to create focused, curated playlists.

Example use cases

• Resume playback, jump to the next track, or set volume from a script or voice command.
• Generate a monthly playlist of top tracks: make-playlist "Top March" short 20.
• Explore an artist neighborhood: discover "Portishead" 3 3 to fetch related artists and tracks.
• Create a playlist of songs you liked from a particular artist: liked-by-artist "Artist Name".
• Build a discovery playlist from your genre profile using discover and then add-to-playlist.