← Back to directory

Spotifyscraper

Community

Public Spotify metadata, lyrics and podcasts for LLM agents. No API key, read-only.

GitHub source repository ↗

★ 298 Stars Category · Other Very popular Source revision 9cbf05aa4963

61FMRS · C

Reliability

8/20

Security and permissions

14/20

Maintenance

14/20

Documentation

13/20

Setup experience

12/20

SpotifyScraper provides a valuable keyless access to Spotify data for AI agents, but it relies on unofficial endpoints, posing breakage risk, and is suitable for non-critical read-only use cases.

Read the FMRS scoring method →

SpotifyScraper is an MCP server that extracts tracks, albums, artists, playlists, podcasts, and lyrics from Spotify's public web data. It does not require the official API or an API key, instead bootstrapping an anonymous token from Spotify's public embed pages and reading the same JSON endpoints the web player uses. It offers sync and async Python clients, typed immutable models, and an MCP server for easy access by AI agents like Claude. Optional authenticated features (lyrics, podcast transcripts) use your Spotify sp_dc cookie—no password or API key required.

Tools

The tool list has not been reviewed yet.

Setup

Install the Python package: pip install 'spotifyscraper[mcp]'. Then configure your MCP client to run spotifyscraper-mcp. Optionally, set the SPOTIFY_SP_DC environment variable to enable authenticated tools.

Fit and risk

Best for

Developers needing quick, keyless access to public Spotify metadata.
LLM applications that want to provide Spotify data to agents.
Personal projects needing music metadata for audio content.
Researchers looking to add music search to AI applications.

Not for

Applications that need to write to a user's Spotify account or access private/library data.
Use cases requiring market-accurate availability or region-specific data.
Production-critical applications where breakage risk is unacceptable.

Required permissions

No authentication is required by default.
Optionally, SPOTIFY_SP_DC cookie is required to enable lyrics, transcripts, and account tools. This cookie is secret.

Risks and side effects

This relies on Spotify's public private endpoints, which can change without notice, causing breakage.
There is risk of Spotify banning, but the library includes anti-ban measures.
This is unofficial and may violate Spotify's terms of service; use for educational or personal purposes.

Troubleshooting

Ensure Python version is >=3.10.
Check if SPOTIFY_SP_DC cookie is valid and not expired.
Verify network connectivity and accessibility of Spotify.
Reinstall the package to get the latest version.

Use cases

Fetch public Spotify track, album, artist, playlist, and podcast data without an API key.

Retrieve lyrics and podcast transcripts in AI applications.

Build Spotify metadata searches for research.

Download cover art and preview clips.

Supported clients

Supported clients have not been confirmed yet.

Related MCP servers

Compare with other MCP servers