유튜브 조회/구독자 추이를 표 + 애니메이션 영상으로 만드는 전체 흐름을,
초보·전문가 모두 이해할 수 있게 정리한 실전 엔지니어링 가이드입니다.
난이도 B(중급) + C(전문가)를 한 슬라이드 덱에서 함께 담았습니다.
유튜브 데이터 → Supabase → Remotion → mp4 까지 한 번에 보여줍니다. 초보자는 상단 설명만, 개발자는 하단 기술 키워드를 함께 보시면 됩니다.
채널/영상 실시간 통계 원본
/api/youtube-manager/trends/*
시계열 스냅샷 영구 저장소
유튜브 추이 표 템플릿 & 렌더
/cron-manager의 조회/구독자 추이 탭에서 합니다./cron-manager · 데이터 수집 관제실
/cron-manager의 조회/구독자 추이(TrendsTab)는UC…), 영상 ID(11자)를 입력/api/youtube-manager/trends/tracked 와 /snapshots Route Handler가 이 화면의 데이터를 제공합니다.자동 판별 분기 로직 · 400 방어 설계
buildTrackBody()가 입력을 자동 판별합니다:UC로 시작 & 24자 → channelId_- → videoIdurlPOST /api/youtube-manager/trends/track 호출 → YouTube API 조회 → Supabase에 스냅샷 1행 Insert.{ channelId: "UCt-BApVtJGrvF5pCgbiNVeg" } → 채널 전용 스냅샷 기록{ videoId: "n8fdEYaDtfM" } → 영상 전용 통계 + 상위 채널 ID 매핑 기록{ url: "..." } → 서버에서 URL 파싱 후 채널/영상 분기 처리30분 주기 스케줄링 & 50개 단위 배치 호출
pg_cron + Edge Function이 30분마다 runTrendsRecord(false)와 동일한 로직을 자동 실행합니다.POST /trends/record {"force": true}를 호출해, 지금 당장 전체 추적 대상을 한 번 더 기록합니다.shouldRecordChannel/Video로 스킵합니다.shouldRecordChannel/Video 검사 후 30분 경과 대상만 수집videos.list / channels.list의 id 파라미터 최대치(50개) 활용추적 대상 목록 + 시계열 기록 통합 설계
channel_id 값이 있고 video_id = NULL 로 저장됩니다. 구독자 수, 채널 총조회수, 총 영상 수를 기록합니다.channel_id와 함께 video_id도 함께 저장됩니다. 개별 영상 조회수, 좋아요, 댓글 수를 기록합니다.| recorded_at | channel_id | video_id | subscribers | views / likes / comments |
|---|---|---|---|---|
| 2026-03-11 01:00 | UCxxxx... | NULL (채널 행) | 49,800 | 채널 총조회수, 영상 수(video_count)… |
| 2026-03-11 01:00 | UCxxxx... | 영상ID (11자) | — | 개별 영상 조회수, 좋아요, 댓글 수… |
실제 DB 적재 로그 · 30분 간격 시계열
n8fdEYaDtfM 기준 샘플입니다.| recorded_at | views (조회수) | likes (좋아요) | comments (댓글) |
|---|---|---|---|
| 2026. 3. 11. 오후 1:30:01 | 5,852,201 | 245,275 | 24,868 |
| 2026. 3. 11. 오후 2:00:01 | 5,855,855 | 245,323 | 24,878 |
| 2026. 3. 11. 오후 2:30:01 | 5,859,580 | 245,370 | 24,887 |
| 2026. 3. 11. 오후 3:00:01 | 5,864,143 | 245,435 | 24,890 |
| 2026. 3. 11. 오후 3:30:01 | 5,867,895 | 245,481 | 24,899 |
| 2026. 3. 11. 오후 4:00:01 | 5,871,955 | 245,541 | 24,902 |
| 2026. 3. 11. 오후 4:30:01 | 5,876,060 | 245,601 | 24,918 |
| 2026. 3. 11. 오후 5:00:01 | 5,879,658 | 245,671 | 24,929 |
| 2026. 3. 11. 오후 5:30:01 | 5,882,803 | 245,733 | 24,940 |
| 2026. 3. 11. 오후 6:00:01 | 5,887,619 | 245,798 | 24,961 |
채널 단위 시계열 스냅샷 예시
UCt-BApVtJGrvF5pCgbiNVeg)에 대해subscribers(구독자 수 1,390,000명), channel_views(채널 누적 조회수 14,718,557회), video_count(업로드 영상 2개).| recorded_at | subscribers | channel_views | video_count |
|---|---|---|---|
| 2026. 3. 11. 오후 3:00:01 | 1,390,000 | 14,718,557 | 2 |
| 2026. 3. 11. 오후 3:30:01 | 1,390,000 | 14,718,557 | 2 |
| 2026. 3. 11. 오후 4:00:01 | 1,390,000 | 14,718,557 | 2 |
| 2026. 3. 11. 오후 4:30:01 | 1,390,000 | 14,718,557 | 2 |
| 2026. 3. 11. 오후 5:00:01 | 1,390,000 | 14,718,557 | 2 |
| 2026. 3. 11. 오후 5:30:01 | 1,390,000 | 14,718,557 | 2 |
| 2026. 3. 11. 오후 6:00:01 | 1,390,000 | 14,718,557 | 2 |
슬라이드 툴 + 타임라인 영상 편집 웹앱
/video-creator는 슬라이드 툴과 타임라인 편집기가 합쳐진 영상 편집 웹앱입니다.@remotion/player로 현재 선택된 씬을 실시간 재생하며 숫자 보간 애니메이션을 확인합니다.프레임 단위 선형 보간 프리뷰 (1080p · 30fps)
프론트 프리뷰와 서버 렌더링의 단일 키 체인
TemplateSelector에서 youtube-stats-table 템플릿 카드를 클릭합니다.addScene이 호출되고, 새 Scene 객체의 type에 youtube-stats-table이 들어갑니다.VideoPlayer는 현재 선택된 Scene의 type을 받아, 내부 getCompositionConfig()로 어떤 Remotion 컴포지션을 쓸지 결정합니다.RemotionRoot에 등록된 id="youtube-stats-table" 컴포지션이 최종 선택됩니다.youtube-stats-table 템플릿 카드 클릭scene.type = "youtube-stats-table" 상태로 타임라인에 씬 추가type을 읽어 렌더링할 컴포지션 컴포넌트와 기본 Props 결정project.composition으로 같은 id를 사용할 수 있습니다.한 행 = 한 시점을 나타내는 배열 구조
rows 배열을 입력으로 받습니다.date(일시), subscribers(구독자), views(조회수), rate(증감/비율), likes(좋아요), comments(댓글).RAW_ROWS 상수와 DEFAULT_YOUTUBE_STATS_ROWS를 분리해 사용합니다."4.9만", "~ 290,000" 같은 문자열(string)이므로, 영상 애니메이션을 위해 숫자 파싱과 구간별 보간이 필요합니다 (다음 슬라이드).| date | subscribers | views | rate | likes | comments |
|---|---|---|---|---|---|
| 03. 04. 01:17 | 4.9만 | ~ 290,000 | +1,200 | 3,100 | 420 |
매 프레임 숫자가 부드럽게 올라가는 원리
"4.9만" 같은 문자열인데, 애니메이션은 프레임마다 숫자로 계산해야 하므로"4.9만" → 49000 / "~ 290,000" → 290000 / "-" 또는 "채널 개설" → 0"+1,200" → 1200 / "3.2%" → 3.2"03. 04. 01:17" → 1,277 (분) (타임라인 위치 계산·보간용)frame)과 durationPerRow(한 행당 프레임 수)로 “지금이 몇 번째 행과 다음 행 사이의 몇 % 지점인지”를 구한 뒤, 그 비율만큼 이전 행 숫자와 다음 행 숫자를 섞어(선형 보간) 표시합니다.parseCount (개수→number) · ② parseRate (증감/비율→number) · ③ dateToMinutes (경과 분 계산) · ④ 선형 보간 카운팅30fps 기준 프레임 계산식 & TypeScript 구현
durationPerRow = 90 프레임 (30fps 기준 3초)150 + 9 × 90 + 300 = 1,260 프레임 → 약 42초150 + 19 × 90 + 300 = 2,160 프레임 → 약 72초150 + 39 × 90 + 300 = 3,960 프레임 → 약 132초/** 구독자/조회수/좋아요/댓글 숫자 파싱 (표시용 원본 유지, 보간용 숫자) */ function parseCount(s: string): number { if (!s || s === '-' || s === '채널 개설') return 0; const t = s.replace(/^~\s*/, '').trim().replace(/,/g, ''); const man = t.match(/^([\d.]+)\s*만$/); if (man) return Math.round(parseFloat(man[1]) * 10000); const n = parseFloat(t.replace(/[^\d.]/g, '')); return Number.isNaN(n) ? 0 : Math.round(n); } /** 구독률 파싱 */ function parseRate(s: string): number { if (!s || s === '-') return 0; const n = parseFloat(s.replace('%', '')); return Number.isNaN(n) ? 0 : n; } /** 일시 문자열 → 경과 분 (03. 02. 0:00 기준) */ function dateToMinutes(dateStr: string): number { if (!dateStr) return 0; const withTime = dateStr.match(/03\.\s*(\d{1,2})\.\s*(\d{1,2}):(\d{1,2})/); if (withTime) { const day = parseInt(withTime[1], 10); const hour = parseInt(withTime[2], 10); const min = parseInt(withTime[3], 10); return (day - 2) * 24 * 60 + hour * 60 + min; } const dayOnly = dateStr.match(/03\.\s*(\d{1,2})\.\s*[\(\d]/); if (dayOnly) { const day = parseInt(dayOnly[1], 10); return (day - 2) * 24 * 60; } return 0; } /** 경과 분 → "03. DD. HH:mm" */ function minutesToDateLabel(totalMinutes: number): string { const day = 2 + Math.floor(totalMinutes / (24 * 60)); const remainder = Math.max(0, totalMinutes % (24 * 60)); const hour = Math.floor(remainder / 60); const min = Math.round(remainder % 60); return `03. ${String(day).padStart(2, '0')}. ${String(hour).padStart(2, '0')}:${String(min).padStart(2, '0')}`; } export interface YoutubeStatsRowParsed { date: string; minutesFromStart: number; subscribers: number; views: number; rate: number; likes: number; comments: number; }
어떤 채널·영상이든 그대로 복붙하는 표준 절차
/cron-manager → 조회/구독자 추이 탭에서 원하는 채널/영상을 추가합니다.date, subscribers, views, rate, likes, comments 문자열을 생성합니다.YoutubeStatsTableComposition의 RAW_ROWS를 이 데이터로 교체(또는 새 상수로 분리)합니다./video-creator에서 youtube-stats-table 씬을 추가해 미리보기 → 필요 시 mp4/webm 렌더.YoutubeStatsTableComposition.tsx의 RAW_ROWS 배열에 주입GitHub 39k+ 스타 · “코드로 영상” 프레임워크
/api/video-creator/render는 바로 Remotion의 서버 사이드 렌더링을 호출해 mp4/webm 파일을 만드는 단계입니다.편집기 애니메이션을 실제 영상 파일로 변환
mp4 (h264), webm (vp8) 두 가지 표준 비디오 코덱 포맷을 지원합니다.low (60) · medium (75) · high (90) 3단계 품질 프리셋을 선택할 수 있습니다.id="youtube-stats-table" 컴포지션 메타데이터(해상도, fps, 프레임 수) 선택서버 환경·권한·FFmpeg 문제 우회 전략
/video-creator에서 유튜브 추이 표 씬을 전체 화면에 가깝게 키웁니다.Shift+Cmd+5) 등을 켭니다.mp4 파일을 얻습니다.@remotion/player는 브라우저 안에서 이미 완벽한 60fps/30fps 벡터·DOM 애니메이션을 렌더링 중입니다.이중 라이선스(Dual License) 체계 완벽 정리
remotion.pro에서 구매.| 구분 (법적 주체 및 활용 시나리오) | 무료 사용 가능 여부 |
|---|---|
| 개인 유튜버의 상업적 영상 제작 (유튜브 수익 창출 포함) | 가능 (무료) |
| 3인 이하 스타트업의 자체 상업적 영상 제작 | 가능 (무료) |
| 비영리 단체의 영상 제작 | 가능 (무료) |
| 직원 4명 이상 기업의 영상 제작 | 회사 라이선스 필요 (remotion.pro) |
| Remotion 기반 SaaS 제품 판매 (제3자에게 편집기 유료 판매·임대) | 불가 (파생물 판매 금지) |
• 복잡한 코드는 신경 쓰지 말고, “데이터를 표로 쌓는다 → 그 표를 예쁜 영상으로 바꾼다”라고 이해하면 충분합니다.
• 이 흐름은 김선태 채널뿐 아니라 어떤 채널/영상에도 그대로 복붙할 수 있습니다.
• 핵심 키워드: /trends/* API, Supabase 시계열 설계, Remotion 컴포지션 id, 서버 렌더링 API.
• 확장 아이디어: 다른 지표(수익, 시청 지속 시간), 다른 플랫폼(Twitch, TikTok), 다른 템플릿(막대 그래프, 맵 시각화)으로 응용 가능합니다.
실패 없는 3단계 분할 지시 전략
/cron-manager, /video-creator 페이지와 상단 공통 네비게이션 레이아웃 정도만 요청해 라우팅과 타입 규칙을 잡습니다.TrendsTab UI를 얹도록 단계별로 시킵니다.RAW_ROWS 변환 스크립트를 각각 따로따로 요청하는 식으로 쪼갭니다.app/cron-manager/page.tsx, app/video-creator/page.tsx + TypeScript Strict (no-any) 규칙 확립lib/youtube-client.ts + lib/db/youtube-trends-store.ts + track / record / tracked / snapshots 4종TrendsTab.tsx + YoutubeStatsTableComposition.tsx + /api/video-creator/render + 변환 스크립트