Spotify와 YouTube Music 선곡 상호보완 설계

환경: Python 3.14, Spotify 개인 믹스, YouTube Music OAuth

1. 문제와 Python 라이브러리

Spotify 전용 SDK 대신 httpx를 사용한 이유는 웹 플레이어 GraphQL 요청과 브라우저 세션 토큰 흐름을 직접 제어하기 위해서다. YouTube Music 쪽은 비공식 API 처리와 OAuth 세션 관리를 제공하는 ytmusicapi로 감싼다.

2. 선곡 상호보완 구조

이 자동화는 두 추천 알고리즘을 직접 결합하거나 전역 좋아요를 동기화하지 않는다. 대신 사용자가 YTM에서 발견한 곡을 Spotify의 학습용 플레이리스트로 보내고, Spotify가 만든 개인 믹스를 YTM에서 재생할 미러로 되돌린다. 즉, YTM의 발견 경로와 Spotify의 개인화 피드백 루프를 서로의 입력으로 사용한다.

flowchart LR
    subgraph YTM[YouTube Music]
        A[추천 · 검색 · 재생 중 발견] --> B[Send to Spotify 받은편지함]
        G[Spotify 믹스 미러]
    end

    subgraph ST[Spotify]
        C[Imported from YTM 플레이리스트] --> D[개인화 학습 신호]
        D --> E[Discover Weekly · Release Radar · 개인 믹스]
    end

    B -->|검증된 곡만 추가 후 큐에서 제거| C
    E -->|검증된 곡 비율이 임계값 이상일 때 재구성| G

YTM 받은편지함은 일회성 전송 큐다. 성공적으로 Spotify에 추가된 곡만 큐에서 제거하므로, 찾지 못했거나 후보가 모호한 곡은 수동 검토를 위해 남는다. Spotify의 Imported from YTM은 일반 재생목록으로, 전역 Liked Songs를 변경하지 않으면서 Spotify에 선호 신호를 제공한다.

반대 방향은 Spotify의 Discover Weekly, Release Radar, 개인 장르 믹스처럼 이미 개인화된 결과를 YTM의 전용 미러에 재구성한다. YTM에서 Spotify 믹스를 편하게 재생하면서도, Spotify 쪽 추천 결과를 잃지 않는 구조다.

각 방향의 곡 검색 결과는 제목 55%, 아티스트 25%, 앨범 10%, 재생시간 10%를 합산해 평가한다. 제목의 괄호·대괄호 부가 표기는 정규화하고, 재생시간 차이는 30초 이내에서 점진적으로 감점한다. 최고 점수가 0.72 미만이거나 2위 후보와의 점수 차가 0.025 미만이면 자동 선택하지 않는다. Spotify에서 YTM으로 보낼 때는 ATV 또는 AUDIO 유형 후보에 작은 우선순위를 준다.

동기화 작업은 먼저 Spotify 세션과 YTM OAuth를 모두 검증한다. 인증에 실패하면 어느 플레이리스트도 수정하지 않는다. 처리 결과는 추가·제거·건너뜀·모호함·오류로 나누어 기록한다.

3. 매칭과 데이터 보호

~/.local/share/music-sync/history.sqlite3 이력 DB에는 서비스 간 검증 완료한 곡 ID와 매칭 신뢰도를 저장한다. 다음 동기화에서 같은 곡을 다시 검색하지 않아 중복 추가와 불필요한 API 요청을 줄인다.