Add local Suno companion service

README.md

@@ -52,6 +52,14 @@ WAV 다운로드는 SUNO 계정 권한, 변환 준비 상태, CDN 접근 정책
 2. `처리용 manifest 저장`을 눌러 Downloads 폴더에 `suno-library-YYYY-MM-DD.manifest.json`을 저장합니다. 이 단계에서 브라우저가 SUNO의 `convert_wav/`와 `wav_file/` API를 호출해 WAV URL을 준비합니다.
 3. `run_process_suno_library.ps1`을 실행합니다.
 
+더 편한 흐름:
+
+1. 먼저 `run_suno_companion.ps1`을 실행해서 로컬 수신 프로그램을 켜둡니다.
+2. SUNO 라이브러리에서 `라이브러리 곡 감지`를 누릅니다.
+3. `로컬 프로그램으로 처리`를 누릅니다.
+
+이 경우 Tampermonkey가 manifest를 `http://127.0.0.1:17873/process`로 보내고, 로컬 프로그램이 자동으로 다운로드/FLAC 변환/정리를 시작합니다.
+
 기본 출력 위치:
 
 ```text
@@ -59,3 +67,5 @@ WAV 다운로드는 SUNO 계정 권한, 변환 준비 상태, CDN 접근 정책
 ```
 
 로컬 처리기는 manifest에 저장된 WAV URL을 다운로드하고, 실패하면 manifest의 audio URL로 fallback합니다. 이후 ffmpeg로 FLAC 변환하면서 title, artist, album, genre/style, lyrics, Suno clip id, cover art를 메타데이터로 넣습니다.
+
+로그는 `companion-logs` 폴더에 저장됩니다.