# spotifyscraper

An MCP server for fetching public Spotify metadata, track lyrics, and podcast details. Works without official developer API keys.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 322
- Author: AliAkhtari78
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AliAkhtari78/SpotifyScraper
- Updated: 2026-09-18
- HTML: https://affpapa.org/en/nevibecode/mcp/spotifyscraper

## What it does

spotifyscraper connects LLM hosts directly to Spotify's open web endpoints. Instead of requiring developer registration and OAuth credentials, it pulls an anonymous session token from public embeds. Your assistant can look up tracks, inspect albums, fetch playlists, and discover related artists.

The server is strictly read-only, which means it cannot modify playlists or control media playback. General catalog metadata requires zero login. If you want lyrics or podcast transcripts, you must pass your personal Spotify `sp_dc` cookie in the environment configuration. The package runs on Python 3.10 and later.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `SPOTIFY_SP_DC` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add spotifyscraper -e SPOTIFY_SP_DC=<SPOTIFY_SP_DC> -- uvx spotifyscraper
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from spotifyscraper <command>

### Codex

**Platform CLI**
```bash
codex mcp add spotifyscraper --env SPOTIFY_SP_DC=<SPOTIFY_SP_DC> -- uvx spotifyscraper
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from spotifyscraper <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "spotifyscraper": {
            "command": "uvx",
            "args": [
                "spotifyscraper"
            ],
            "env": {
                "SPOTIFY_SP_DC": "<SPOTIFY_SP_DC>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from spotifyscraper <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "spotifyscraper": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "spotifyscraper"
            ],
            "env": {
                "SPOTIFY_SP_DC": "<SPOTIFY_SP_DC>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from spotifyscraper <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SPOTIFY_SP_DC=<SPOTIFY_SP_DC> spotifyscraper uvx spotifyscraper
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from spotifyscraper <command>

## When to use it
- Pull track and album metadata without registering a Spotify developer app
- Retrieve related artists and track recommendations after official API deprecations
- Fetch song lyrics and podcast transcripts using a session cookie
- Inspect podcast episode details and show notes for agent context

## Example prompts
- Get details and tracklist for album ID 6N9PS4QXF1D0OWPk0Sxtb4
- Fetch the lyrics and preview link for track ID 4uLU6hMCjMI75M1A2tKUQC
- Find recommendations and related artists for this musician

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md