019 — Spotify 인프라 구축 + 커버 이미지 자동화

날짜: 2026-06-20 KST

레포: parksy-audio/spotify

세션 범위: Spotify OAuth 인프라 완성 → 클래식3형제 플레이리스트 → 커버 이미지 자동화

세션 요약

완료

Spotify Developer 앱 등록 (Client ID: 561fb317121b4f5e96335678fa36f771)

OAuth Authorization Code Flow 완성 → `~/.config/spotify/token.json` 저장

자동 갱신 래퍼 `auth.py` 완성 (만료 50분 전 자동 refresh)

Premium 계정 확인 (`product: premium`, `313ojbglmgwqz5xbsdorbsr63vom`)

API 현황 실측 검증 → 백서 `SPOTIFY-STRATEGY-WHITEPAPER.md` 작성 + 텔레그램 전송

`클래식3형제` 플레이리스트 생성 (ID: `6qL0XJjO4E4HLPSAUd4mPX`)

- Bruckner 6곡 / Mahler 6곡 / Fauré 7곡 = 19트랙

커버 이미지 생성 스크립트 `cover_art.py` 완성

- 600×600 JPEG, 42.6KB

- NotoSerifCJK-Bold 폰트, 딥 네이비 배경, 금색 글씨

- 재사용 가능: --title, --names, --subtitle 파라미터

펜딩

커버 이미지 업로드 (`PUT /playlists/{id}/images`) — `ugc-image-upload` scope 1회 재인증 필요

`parksy_female_vocal_v1` 플레이리스트 (17 여성 보컬 × TOP5) 생성

Bruckner No.9 중복 수정 (Symphony No.2가 2번 들어감)

핵심 발견 — Spotify 2024 API 제한

✅ 동작: 검색, ISRC, 플레이리스트 CRUD, 개인 청취 이력, 현재 재생 중
❌ 차단: audio-features (BPM/키), audio-analysis (pitches 12차원), recommendations

결론: Spotify = DJ/큐레이션 레이어. 피치/BPM = librosa/basic-pitch로 직접 추출.

구조적으로 더 나음 — Spotify 파생물 아니라 법적으로 더 깨끗.

파일 구조 (신규 생성분)

parksy-audio/spotify/
├── scripts/
│   ├── auth.py          ← OAuth 자동 갱신 래퍼 (핵심)
│   └── cover_art.py     ← 플레이리스트 커버 이미지 생성 + 업로드
├── docs/
│   ├── SPOTIFY-STRATEGY-WHITEPAPER.md
│   ├── SPOTIFY-3MONTH-PROJECT.md
│   ├── SPOTIFY-RANGE-AND-SCOPE.md
│   └── FEMALE-VOCAL-SELECTION.md
└── outputs/
    └── playlists_current.json

재현 명령어

# 환경 활성화
source ~/parksy-audio/spotify/.venv/bin/activate

# 커버 이미지 생성 + 업로드
python3 ~/parksy-audio/spotify/scripts/cover_art.py 6qL0XJjO4E4HLPSAUd4mPX \
    --title "클래식3형제" \
    --names "Bruckner × Fauré × Mahler" \
    --subtitle "영감용 레퍼런스 플레이리스트"

# ugc-image-upload scope 재인증 URL (1회 수동 필요)
# https://accounts.spotify.com/authorize?client_id=561fb317121b4f5e96335678fa36f771
# &response_type=code&redirect_uri=https%3A%2F%2Fexample.org%2Fcallback
# &scope=playlist-modify-private+playlist-modify-public
# +user-read-email+user-read-private+ugc-image-upload
# &show_dialog=false

다음 세션 즉시 실행

1. ugc-image-upload code 값 받으면 → auth.py exchange_code() 호출 → 토큰 갱신

2. cover_art.py 실행 → 커버 업로드 확인

3. parksy_female_vocal_v1 플레이리스트 자동 생성

Claude Code | parksy-audio dev-log 019 | 2026-06-20 KST