Spotify Skill

Overview

Quick Install

curl -sSL https://canifi.com/skills/spotify/install.sh | bash

cp -r skills/spotify ~/.canifi/skills/

Setup

# First, ensure canifi-env is installed:
# curl -sSL https://canifi.com/install.sh | bash

canifi-env set SPOTIFY_EMAIL "your-email@example.com"

Privacy & Authentication

Option 1: Manual Browser Login (Recommended)

1. Complete the Browser Automation Setup using CDP mode
2. Login to the service manually in the Playwright-controlled Chrome window
3. Claude will use your authenticated session without ever seeing your password

Option 2: Environment Variables

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Capabilities

• Control playback (play, pause, skip, shuffle, repeat)
• Create, edit, and manage playlists
• Search for songs, artists, albums, and podcasts
• View and manage listening history
• Discover new music through recommendations

Usage Examples

Example 1: Create a Playlist

User: "Create a workout playlist with high-energy songs"
Claude: I'll create a new playlist called "Workout Energy" and add some high-tempo tracks to get you moving.

Example 2: Control Playback

User: "Play some relaxing jazz music"
Claude: I'll search for relaxing jazz and start playing a curated selection for you.

Example 3: Check Listening Stats

User: "What have I been listening to this week?"
Claude: I'll check your recently played tracks and summarize your listening activity.

Authentication Flow

1. Navigate to open.spotify.com via Playwright MCP
2. Click "Log in" button
3. Enter email credentials
4. Handle 2FA if enabled (via iMessage)
5. Maintain session cookies for future requests

Error Handling

• Login Failed: Retry authentication up to 3 times, then notify via iMessage
• Session Expired: Re-authenticate automatically
• Rate Limited: Implement exponential backoff (1s, 2s, 4s)
• 2FA Required: Wait for code via iMessage, enter automatically
• Playback Error: Check device availability, suggest alternatives

Self-Improvement Instructions

1. Document the change with screenshots
2. Update selectors in this skill file
3. Suggest workflow improvements based on usage patterns
4. Log successful and failed operations for optimization

Notes

• Spotify Free accounts have limited skip functionality
• Some features require Premium subscription
• Playback control requires an active Spotify client on a device
• Web player has limitations compared to desktop/mobile apps