Agent skill

spotify-web-api

Spotify control via Web API - playback, history, top tracks, search. Cross-platform (no Mac required).

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/spotify-web-api

Metadata

Additional technical details for this skill

clawdbot 
{
    "emoji": "\ud83c\udfb5",
    "requires": {
        "env": [
            "SPOTIFY_CLIENT_ID",
            "SPOTIFY_CLIENT_SECRET"
        ]
    }
}

SKILL.md

Spotify Web API (Cross-Platform)

Control Spotify via Web API. Works from any platform — no Mac required.

Setup

1. Create Spotify App:

  1. Go to https://developer.spotify.com/dashboard
  2. Create a new app
  3. Add redirect URI: http://localhost:8888/callback
  4. Copy Client ID and Client Secret

2. Set Environment Variables:

bash
export SPOTIFY_CLIENT_ID="your_client_id"
export SPOTIFY_CLIENT_SECRET="<GOOGLE_OAUTH_CLIENT_SECRET_REDACTED>"

3. Authenticate:

bash
python3 {baseDir}/scripts/spotify.py auth

Opens browser for OAuth. Token cached in ~/.spotify_cache.json.

Commands

bash
# Currently playing
python3 {baseDir}/scripts/spotify.py now

# Recently played
python3 {baseDir}/scripts/spotify.py recent

# Top tracks/artists
python3 {baseDir}/scripts/spotify.py top tracks --period month
python3 {baseDir}/scripts/spotify.py top artists --period year

# Playback control
python3 {baseDir}/scripts/spotify.py play
python3 {baseDir}/scripts/spotify.py play "bohemian rhapsody"
python3 {baseDir}/scripts/spotify.py pause
python3 {baseDir}/scripts/spotify.py next
python3 {baseDir}/scripts/spotify.py prev

# Search
python3 {baseDir}/scripts/spotify.py search "daft punk"

# List devices
python3 {baseDir}/scripts/spotify.py devices

Example Chat Usage

  • "What am I listening to?"
  • "What have I listened to lately?"
  • "What are my top tracks this month?"
  • "Play Bohemian Rhapsody"
  • "Skip this song"
  • "Pause the music"

Requirements

  • Spotify Premium (for playback control)
  • Free accounts can still view history/top tracks

API Reference

Uses the Spotify Web API: https://developer.spotify.com/documentation/web-api

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results