spotify-apilisted
Install: claude install-skill nikhonit/social-media-api-skills
# Spotify API skill
Read public Spotify catalogue data as clean JSON. This Spotify API skill returns a track, album, artist, an artist's top tracks, a playlist, or search results across the catalogue — 2 credits per call, no OAuth dance, no token refresh loop.
This skill wraps **6 live Spotify endpoints** from the [ScraperSocial](https://scrapersocial.com) API. Public data only, returned as clean JSON.
## When to use this skill
- A user pastes a Spotify link and wants the track, album or artist details.
- You are building a music research or recommendation workflow that needs catalogue metadata.
- You want an artist's top tracks or the contents of a public playlist.
### Do not use this skill when
- **You are building a real music app.** Spotify's own Web API is free, richer, covers playback and user libraries, and is the licensed route. Use this when you want one client across many platforms and no OAuth setup.
- **You need audio, streams or private library data.** Catalogue metadata only.
- **You need listener counts or royalties.** Not published, not available.
## Setup
```bash
export SCRAPERSOCIAL_KEY=sk_live_... # https://scrapersocial.com/app/keys
```
Signing up at [scrapersocial.com/signup](https://scrapersocial.com/signup) includes 100 free credits, no card required.
## Scripts
| Script | What it does | Input | Credits |
|---|---|---|---|
| `get_album.js` | Get Spotify album. | handle | 2 credits |
| `get_artist.js` | Get Spotify artist. | handle | 2 credi