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 웹 플레이어가 사용하는 동일한 JSON 엔드포인트를 읽어옵니다. 데이터는 타입 지정되고 변경 불가능한 모델로 반환됩니다. 고급 기능인 가사 및 팟캐스트 트랜스크립트를 위해서는 사용자가 Spotify의 sp_dc 쿠키를 선택적으로 제공함으로써 비밀번호 없이 인증할 수 있습니다.

대상 사용자

Spotify의 공개 메타데이터에 빠르고 API 키 없이 접근이 필요한 개발자, 또는 Model Context Protocol (MCP)를 통해 Spotify 데이터 통합이 필요한 AI 에이전트를 개발하는 사람.

주요 특징

API 키 필요 없음: 등록이나 OAuth 없이 공개 데이터에 접근 가능.
MCP 서버: Claude와 같은 LLM 에이전트에 Spotify 데이터를 노출할 수 있는 즉시 사용 가능한 MCP 서버 포함.
포괄적인 데이터: 트랙, 앨범, 아티스트, 플레이리스트, 쇼, 에피소드를 포함한 커버 아트와 30초 미리듣기까지 추출 가능.
인증된 확장 기능: 쿠키 인증을 통해 가사 및 팟캐스트 트랜스크립트 지원.
내구성: 일일 카니발 테스트 세트와 자동 폴백 메커니즘을 통해 Spotify 내부 API 변경에 대응.
개발자 친화적: 동기 및 비동기 클라이언트, CLI 도구, 선택적 응답 캐싱 제공.