# 서론 – “음악 공유가 여기서 멈추면 안 되잖아요?”

Music Monday는 매주 월요일마다 커뮤니티 멤버들이 댓글에 추천곡을 남기는 음악 공유 프로젝트입니다.

하지만 댓글에 적힌 곡들을 일일이 찾아서 Spotify 플레이리스트에 추가한다면 시간도 오래 걸리고 실수도 생기기 마련이죠.

이런 불편을 해소하고자 Ruby로 만든 작은 유틸리티, Music Monday Spotify Sync Bot을 오픈소스로 공개했습니다.

이 글에서는 Spotify 플레이리스트, Ruby 자동화, Music Monday 라는 SEO 키워드를 중심으로, 초보자도 이해할 수 있도록 단계별로 구현 과정을 살펴보겠습니다.

---

# 1️⃣ 프로젝트 개요 – 어떤 문제를 해결하나요?

| 문제 | 기존 방식 | 자동화 솔루션 |

|------|-----------|--------------|

| 댓글에 적힌 곡을 수동으로 검색 | Spotify 앱을 열고 검색 → 곡 추가 | Ruby 스크립트가 댓글을 파싱 → 곡 ID 추출 → API 호출로 자동 추가 |

| 여러 곡을 일괄 추가할 때 실수 발생 | 하나씩 클릭 | 한 번에 전체 곡을 처리 |

| 작업 기록이 남지 않음 | 기억에 의존 | 로그 파일에 성공/실패 기록 저장 |

이러한 문제를 Ruby 자동화 스크립트가 해결합니다. 간단한 설정만으로 Music Monday 댓글을 읽고, 해당 곡을 Spotify 플레이리스트에 자동으로 동기화합니다.

---

# 2️⃣ 준비 단계 – 필수 도구와 계정 설정

# 2.1 Ruby 설치

• macOS: brew install ruby

• Windows: RubyInstaller 사용

• Linux: sudo apt-get install ruby-full

# 2.2 Spotify 개발자 계정 만들기

1. Spotify Developer Dashboard에 로그인

2. “Create an App” 클릭 → Client ID와 Client Secret 복사

3. Redirect URI에 http://localhost:8888/callback 입력 후 저장

# 2.3 Music Monday API (또는 댓글 스크래핑) 준비

Music Monday는 공식 API가 없으므로, 공개된 RSS 피드 혹은 HTML 파싱을 이용합니다. 이번 예제에서는 RSS 피드를 활용합니다.

# 2.4 필요한 Gem 설치

bash

gem install httparty json dotenv

• httparty : HTTP 요청 처리

• json : JSON 파싱

• dotenv : 환경 변수 관리

---

# 3️⃣ 코드 구현 – 핵심 로직 4단계

# 3.1 환경 변수 로드 (.env 파일)

env

SPOTIFY_CLIENT_ID=your_client_id

SPOTIFY_CLIENT_SECRET=your_client_secret

SPOTIFY_PLAYLIST_ID=your_playlist_id

MUSIC_MONDAY_RSS=https://musicmonday.com/rss

# 3.2 Spotify 인증 토큰 얻기

ruby

require 'httparty'

require 'json'

require 'dotenv/load'

def fetch_spotify_token

  response = HTTParty.post(

    'https://accounts.spotify.com/api/token',

    body: { grant_type: 'client_credentials' },

    headers: {

      'Authorization' => 'Basic #{Base64.strict_encode64('#{ENV['SPOTIFY_CLIENT_ID']}:#{ENV['SPOTIFY_CLIENT_SECRET']}')}'

    }

  )

  JSON.parse(response.body)['access_token']

end

# 3.3 Music Monday 댓글에서 트랙 정보 추출

ruby

require 'rss'

def fetch_tracks_from_monday

  rss = RSS::Parser.parse(ENV['MUSIC_MONDAY_RSS'], false)

  tracks = []

  rss.items.each do |item|

    # 예시: 댓글에 'Artist - Title' 형식으로 적힌 경우

    if item.title =~ /(.*) - (.*)/

      tracks << { artist: $1.strip, title: $2.strip }

    end

  end

  tracks

end

# 3.4 Spotify에 트랙 추가

ruby

def search_spotify_track(token, artist, title)

  query = URI.encode_www_form_component('track:#{title} artist:#{artist}')

  url = 'https://api.spotify.com/v1/search?q=#{query}&type=track&limit=1'

  response = HTTParty.get(url, headers: { 'Authorization' => 'Bearer #{token}' })

  items = JSON.parse(response.body)['tracks']['items']

  items.empty? ? nil : items.first['uri']

end

def add_tracks_to_playlist(token, uris)

  url = 'https://api.spotify.com/v1/playlists/#{ENV['SPOTIFY_PLAYLIST_ID']}/tracks'

  HTTParty.post(

    url,

    body: { uris: uris }.to_json,

    headers: {

      'Authorization' => 'Bearer #{token}',

      'Content-Type' => 'application/json'

    }

  )

end

# 메인 실행 흐름

token = fetch_spotify_token

tracks = fetch_tracks_from_monday

uris = tracks.map { |t| search_spotify_track(token, t[:artist], t[:title]) }.compact

add_tracks_to_playlist(token, uris) unless uris.empty?

puts '✅ #{uris.size}개의 곡이 Spotify 플레이리스트에 추가되었습니다.'

Tip

search_spotify_track 함수는 검색 결과가 없을 경우 nil을 반환합니다. 실제 운영 시에는 로그 파일에 실패 원인을 남겨두면 디버깅이 쉬워요.

---

# 4️⃣ 배포와 자동 실행 – 매주 월요일 자동 동기화

1. GitHub에 저장

bash

   git init

   git add .

   git commit -m 'Initial commit – Music Monday Spotify Sync Bot'

   git push origin main

2. GitHub Actions 설정 (.github/workflows/sync.yml)

yaml

   name: Weekly Sync

   on:

     schedule:

       - cron: '0 9 * * 1'   # 매주 월요일 09:00 UTC

   jobs:

     sync:

       runs-on: ubuntu-latest

       steps:

         - uses: actions/checkout@v3

         - name: Set up Ruby

           uses: ruby/setup-ruby@v1

           with:

             ruby-version: '3.2'

         - name: Install dependencies

           run: gem install httparty json dotenv

         - name: Run sync script

           env:

             SPOTIFY_CLIENT_ID: ${{ secrets.SPOTIFY_CLIENT_ID }}

             SPOTIFY_CLIENT_SECRET: ${{ secrets.SPOTIFY_CLIENT_SECRET }}

             SPOTIFY_PLAYLIST_ID: ${{ secrets.SPOTIFY_PLAYLIST_ID }}

             MUSIC_MONDAY_RSS: ${{ secrets.MUSIC_MONDAY_RSS }}

           run: ruby sync.rb

이렇게 하면 매주 월요일 자동으로 최신 댓글을 읽고, Spotify 플레이리스트에 반영됩니다. 별도의 서버를 운영할 필요 없이 GitHub Actions만으로 충분합니다.

---

# 5️⃣ 확장 아이디어 – 여러분만의 커스텀 봇 만들기

| 아이디어 | 구현 방법 |

|----------|-----------|

| 다른 스트리밍 서비스 연동 | Apple Music, YouTube Music API 활용 |

| 댓글 포맷 다양화 | 정규표현식 추가·수정 |

| 알림 기능 | Discord webhook 또는 Slack 메시지 전송 |

| UI 제공 | Sinatra 혹은 Rails로 간단한 웹 대시보드 구축 |

위와 같은 기능을 차근차근 추가하면, Ruby 자동화 스킬도 자연스럽게 향상됩니다.

---

# 결론 – 지금 바로 시작해 보세요!

Music Monday의 풍부한 음악 추천을 놓치지 말고, Spotify 플레이리스트에 자동으로 동기화해 보세요.

1️⃣ Ruby와 환경 변수만 준비하면 10분 안에 스크립트를 실행할 수 있습니다.

2️⃣ GitHub Actions를 이용해 매주 월요일 자동 실행까지 설정하면, Music Monday와 Spotify가 완벽히 연결됩니다.

행동 유도

• 지금 바로 레포지토리를 포크하고, .env 파일에 본인 정보를 입력해 보세요.

• 실행 결과를 댓글로 공유하거나, 개선 아이디어를 Pull Request로 보내 주세요!

음악을 사랑하는 모든 개발자와 청취자가 함께 만드는 오픈소스 동기화 봇, 여러분의 참여를 기다립니다. 🎶🚀