Aran404/SpotAPI

Spotify 비공개 API를 브라우저처럼 에뮬레이트하는 Python 라이브러리 — 프리미엄 없이 플레이리스트·곡·아티스트 조회·조작 가능

개발 재료조건 있음 · GPL-3.0데이터·크롤링Python난이도
447+5이번 주0
42포크6이슈

중간맛 분석

Python 비동기 라이브러리로, 동기 버전 대비 v2 async 버전은 동시 작업에서 약 4배 빠릅니다. 사용자 인증(이메일/비밀번호 + CAPTCHA 솔버 또는 쿠키 임포트)과 무인증 조회 모두 지원합니다. pip install spotapi로 즉시 설치 가능하며, 6줄 코드로 곡 검색, 플레이리스트 생성, 아티스트·앨범 정보 조회 가능합니다. 한국어·일본어·중국어 등 다국어 응답 지원.

이런 레포예요

이럴 때 쓰면 좋아요

  • 프리미엄 없이 Spotify 플레이리스트 자동 생성·편집
  • 곡·아티스트·앨범 검색·수집 자동화
  • 개인 재생 기록·좋아요 목록 프로그래밍 방식 조회

핵심 기능

프리미엄·API 키 불필요비공개 API 접근으로 전체 Spotify 기능 제어다국어 지원 및 async/sync 모드

대안 대비 차별점

공식 Spotify Web API(프리미엄 구독 필수)와 달리, SpotAPI는 기본 계정만으로도 비공개 엔드포인트 접근 가능하며 v2 async 버전은 동시 작업에서 4배 빠릅니다.

준비물

  • Python 3.7+
  • 이메일·비밀번호 또는 Spotify 쿠키(세션 임포트 시)
  • CAPTCHA 솔버 API 키(사용자 인증 시, 선택 사항)

바로 시작하기

  1. 라이브러리 설치
pip install spotapi
  1. 사용자 인증으로 로그인(CAPTCHA 솔버 필요)
# 코드 예제 참고: capsolver 대신 solver_clients를 설정해 login
from spotapi import Login, Config, solver_clients
cfg = Config(solver=solver_clients.Capsolver("YOUR_API_KEY"))
instance = Login(cfg, "YOUR_PASSWORD", email="YOUR_EMAIL")
instance.login()
  1. 쿠키 기반 로그인(선택 사항, CAPTCHA 불필요)
# Spotify에 로그인하여 브라우저 개발자 도구에서 쿠키 복사
# JSONSaver 등으로 세션 저장
from spotapi import Login
instance = Login.from_saver(saver, identifier="your_email@example.com")
  1. 곡 검색 예제(인증 불필요)
from spotapi import Song
song = Song()
gen = song.paginate_songs("weezer")
for batch in gen:
    for idx, item in enumerate(batch):
        print(idx, item['item']['data']['name'])
  1. 플레이리스트 생성(인증 필수)
from spotapi import PrivatePlaylist
playlist = PrivatePlaylist(instance)
playlist.create_playlist("My Playlist")
  1. 세션 저장
from spotapi import MongoSaver
instance.save(MongoSaver())

별 추이 · 7일

447+5 / 7일

활용성 · 따라 만들기 좋은가

샘플 점수 14/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2024년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/Aran404/SpotAPI.svg)](https://www.gitbap.com/r/Aran404/SpotAPI)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기