Google 에코시스템 통합 보고서

**프로젝트**: parksy-audio

**작성일**: 2026-02-23

**상태**: ✅ 전체 연결 완료


1. 요약 (Executive Summary)

parksy-audio 프로젝트의 Google 에코시스템 통합이 완료되었다.

YouTube Data API, YouTube Analytics API, Google Drive(rclone) 3개 서비스가

모두 연결되어, 로컬 PC에서 오디오 생산 → 마스터링 → 업로드 → 분석

전체 파이프라인을 자동화할 수 있는 기반이 마련되었다.


2. 시스템 아키텍처

┌─────────────────────────────────────────────────────┐
│                  parksy-audio 파이프라인              │
│                                                       │
│  [MIDI 소싱]                                          │
│     ↓ Mutopia / Piano-midi.de / Lyria 3               │
│  [표현 엔진] piano_expression.py                      │
│     ↓ velocity, pedal, tempo 인간화                   │
│  [품질 게이트] midi_quality_gate.py                   │
│     ↓ A/B/C/D/F 등급 판정                            │
│  [렌더링] FluidSynth + SoundFont                      │
│     ↓ WAV 출력                                        │
│  [마스터링] optimizer.py v4                            │
│     ↓ 3-Layer 믹싱 (Ambient + Music + Voice)          │
│  [비주얼] make_visual_video.py                        │
│     ↓ MP4 영상 생성                                   │
│  ┌──────────────────────────────────────┐             │
│  │  ★ Google 에코시스템 (NEW)           │             │
│  │                                      │             │
│  │  [YouTube Upload] youtube-studio.js  │             │
│  │     ↓ API v3 직접 업로드             │             │
│  │  [YouTube Analytics] 조회수/구독 추적│             │
│  │  [Google Drive] rclone gdrive:       │             │
│  │     ↓ 백업 + 크로스디바이스 동기화    │             │
│  └──────────────────────────────────────┘             │
└─────────────────────────────────────────────────────┘

3. 연결 현황

3.1 YouTube Data API v3

항목
GCP 프로젝트parksy-youtube
OAuth 클라이언트parksy-cli (Desktop App)
인증 계정Parksy (Account A)
연결 채널Blogger-Parksy
스코프youtube, youtube.upload, youtube.readonly, yt-analytics.readonly
토큰 위치`tools/youtube/token.json`
자동 갱신✅ refresh_token으로 자동

3.2 Google Drive (rclone)

항목
리모트 이름gdrive
동기화 경로gdrive:parksy-audio/
총 용량15 GiB
사용 중1.7 KiB
여유 공간14.3 GiB
설정 위치%APPDATA%\rclone\rclone.conf

3.3 스크립트 연결 상태

스크립트용도상태
`tools/youtube/auth.js`OAuth 토큰 생성/갱신✅ 작동 확인
`tools/youtube/youtube-studio.js`채널 관리 + 업로드✅ status 명령 확인
`tools/gdrive-sync.sh`Google Drive ↔ 로컬 동기화✅ rclone about 성공
`tools/sync-lyria3-to-image.sh`parksy-image 레포 동기화✅ 버그 수정 완료

4. 보안 현황

4.1 자격증명 보호

파일내용.gitignoregit 추적
client_secret.jsonOAuth 클라이언트 ID/Secret✅ 등록됨❌ 추적 안 됨
token.json액세스/리프레시 토큰✅ 등록됨❌ 추적 안 됨
rclone.confGoogle Drive 토큰시스템 경로해당 없음

4.2 OAuth 앱 상태