25.08.17 / JUN
유튜브 24시간 최다조회수 롱폼 TOP10을 자동으로 뽑아 블로그에 보여주는 워드프레스 플러그인을 바이브코딩 방식으로 빌드하는 방법을 소개합니다.
앞서 두 번의 프로젝트에서 얻은 교훈을 바탕으로 한국 사용자의 관심 트렌드에 초점을 맞췄고, YouTube Data API 비용을 최소화하기 위해 videos.list?chart=mostPopular 기반 + 장기 캐시를 적용했습니다.
쿼터 초과(403) 등 오류가 발생하면 직전 성공 결과를 보여주도록 폴백 처리했습니다.
🔥 24시간 최다조회수 유튜브 영상 TOP10
Goodbyes and Sad Eyes (Goodbyes and Sad Eyes)
북극성 | 메인 예고편 | 디즈니+
DRX vs DNF - GEN vs NS | 2025 LCK
Because I Loved You
Alien Earth: EP. 4 - NEW TRAILER 'Observation' | 4K
If I Had Time
2만 로벅스 멸망전 끝에 드디어 얻게된 드래곤 시크릿!!! 근데 다른 좋은 시크릿도 다 뜬다!? 운 뭐야!! (로블록스 브레인롯훔치기)
CORTIS (코르티스) 'What You Want' Official MV
왜 24시간 · 롱폼 · 한국 트렌드인가
- 24시간: 급상승 영상을 빠르게 포착 → 트렌드성 콘텐츠 큐레이션에 최적
- 롱폼: 쇼츠 대비 설명/맥락/머무름이 길어 블로그 방문자 체류시간↑
- 한국 트렌드:
region=KR+ 카테고리/쿼리 튜닝으로 국내 관심사 반영
아키텍처 개요
- 데이터 소스:
videos.list?chart=mostPopular(저비용, 지역 트렌딩 반영) - 필터: 업로드 24시간 내, 롱폼(≥61초) 기준
- 캐시: 30~120분 권장(페이지 트래픽/섹션 수에 따라 조정)
- Refresh: 관리자만 노출
- 오류 폴백:
403(Forbidden/Quota)발생 시 최근 성공 결과 노출
비용 절감 포인트:
search.list(100유닛)대신videos.list(1유닛)중심으로 호출 빈도↓.
설치 & 사용
- 플러그인 ZIP 업로드 → 설치 & 활성화
- 관리자 설정에서 YouTube Data API Key 입력
- 페이지/포스트에 숏코드 삽입
youtube-hot10-24h-by-jun- 옵션 예시
youtube-hot10-24h-by-jun max="10" // 기본 TOP10youtube-hot10-24h-by-jun region="KR" max="12" // 한국 트렌드 강화youtube-hot10-24h-by-jun cache_minutes="60" // 장기 캐시(권장)youtube-hot10-24h-by-jun category_id="24" // 예능(Entertainment)youtube-hot10-24h-by-jun mode="trending" // 저비용 트렌딩 모드 고정
한국 관심도 반영 튜닝 팁
region="KR"고정 +category_id(예: 24 예능, 10 음악, 20 게임, 25 뉴스)- 특정 주제 보강 시
query에 한국어 키워드 추가(예:query="컴백 댄스 챌린지") - 실시간성 높이면
cache_minutes="15~30", 비용 안정화는60~120권장
KIRO 바이브코딩 후기
- 아이디어 → 프롬프트로 입력 → 초안 생성
- 설치 후 오류 → 설명 + 재시도로 빠른 수정
- 403/쿼터/데이터 로딩 이슈 → 캐시·폴백 설계로 안정화
- 결과: 실사용 가능한 플러그인을 짧은 시간에 완성
FAQ
Q1. Youtube API의 고질적인 403/쿼터 초과 문제 어떻게 해결했나요?
A. 오류 메시지 대신 직전 성공 결과를 자동 노출해 UX 저하를 방지합니다.
Q2. Youtube API 호출 비용은 어떻게 줄였나요?
A. search.list(100유닛) 대신 videos.list(1유닛) 중심으로 호출해 두 자릿수~세 자릿수 배 절감 효과가 납니다. 캐시를 늘리면 더 좋아요.
Q3. 한국 트렌드는 어떻게 반영되나요?
A. region=KR + category_id +(선택) query 조합으로 후보군을 국내 위주로 좁힙니다.
Q4. 일반 사용자에게 Refresh가 보이나요?
A. 아니요. 관리자만 노출되도록 처리했습니다.
참조링크
바이브코딩 프롬프트 예시
워드프레스 플러그인 개발 프로젝트
- 플러그인 이름: YOUTUBE-HOT10-in-24H-by-JUN
- 숏코드: youtube-hot10-24h-by-jun
개요: 24시간 최다조회수 유튜브 영상 TOP10 추천
- 24시간 내 최다조회수를 기록한 유튜브 롱폼 영상을 추천하는 워드프레스 플러그인 빌드
- 한국 사용자의 관심 트랜드에 초점
- Youtube API 비용 절감을 위해 캐시는 가급적 길게, videos.list?chart=mostPopular로 설정
- 일반 사용자에게는 Refresh 버튼 비노출
- Youtube API 일일 할당량 초과등의 문제로 ‘HTTP Error: 403 – Forbidden – Forbidden: API key may be restricted or quota exceeded’와 같은 오류 발생 시, 오류 메시지 대신 지난 결과 보여주기
이 포스트는 지속적으로 업데이트됩니다. / 첫 포스팅: 25.08.17 / 문의: JUN (naebon@naver.com)
