AliAkhtari78/SpotifyScraper

Extract public Spotify data — tracks, albums, artists, playlists, podcasts & lyrics — without the official API. Sync + async, typed models, one dependency.

何を解決するか

SpotifyScraper は、公式 API キー、アプリ登録、OAuth フローを必要とせずに、Spotify（トラック、アルバム、アーティスト、プレイリスト、ポッドキャスト）のパブリックメタデータを抽出する方法を提供します。公式 Web API のセットアップの手間を回避しつつ、最近新規の公式 API アプリで制限された関連アーティストやおすすめ情報などのデータにアクセスできます。

動作方法

このライブラリは Spotify のパブリック埋め込みページから匿名トークンを取得し、Spotify Web プレーヤーが使用している同じ JSON エンドポイントを読み取ります。データは型指定され、変更不可なモデルとして返されます。Lyrics やポッドキャストのトランスクリプトといった高度な機能については、ユーザーが Spotify の sp_dc クッキーをオプションで提供することで、パスワードなしで認証できます。

対象ユーザー

Spotify のパブリックメタデータに高速かつキー不要でアクセスが必要な開発者、および Model Context Protocol (MCP) を通じて Spotify データ統合を必要とする AI エージェントを開発している人。

特徴

API キー不要: 登録や OAuth なしでパブリックデータにアクセス可能。
MCP サーバー: Claude などの LLM エージェントに Spotify データを公開する即插即用の MCP サーバーを内蔵。
包括的なデータ: トラック、アルバム、アーティスト、プレイリスト、番組、エピソード（カバーアートや 30 秒のプレビューを含む）を抽出可能。
認証済み拡張機能: クッキー認証により、Lyrics やポッドキャストのトランスクリプトをサポート。
耐障害性: 日次カニバリテストスイートと自動フォールバック機構により、Spotify の内部 API の変更に対応。
開発者向け: 同期・非同期クライアント、CLI ツール、オプションのレスポンスキャッシュを提供。