Claude Code를 활용한 Zapier의 유튜브 업로드 자동화 도구 구축 사례

섹션별 상세

영상 제작 인원 증가로 인해 1인 담당자에게 집중되던 업로드 및 메타데이터 관리 업무가 병목 현상을 일으켰다. Claude Code를 사용하여 직원들이 직접 로그인하고 정보를 입력하면 채널에 자동 업로드되는 웹 앱을 기획했다. 월 15~20건의 수동 요청을 자동화하여 업무 마찰을 제거했다. 담당자의 개입 없이도 표준화된 업로드 프로세스를 유지할 수 있게 되었다.

근거

담당자는 피크 타임에 월 15~20건의 업로드 요청을 처리해야 했다. — Removing the upload bottleneck without losing oversight 섹션 첫 문단

사용자 인증과 채널 업로드 권한을 분리하기 위해 이중 OAuth 클라이언트 구조를 채택했다. Node.js 서버에서 업로더의 신원 확인용 클라이언트와 유튜브 채널 권한용 클라이언트를 별도로 운영한다. 이를 통해 보안을 유지하면서도 직원들이 채널 비밀번호 없이 업로드할 수 있게 했다. 기업 환경에서 권한 관리와 편의성을 동시에 확보한 설계이다.

Render 호스팅 환경에서 서버 재시작 시 메모리에 저장된 데이터가 소실되어 인증 토큰이 만료되는 문제가 발생했다. Claude의 가이드에 따라 로그를 분석하고 리프레시 토큰의 권한 및 만료 설정을 수정하여 안정성을 확보했다. 24시간 또는 7일마다 끊기던 인증 문제를 해결하여 지속적인 서비스 운영이 가능해졌다. AI를 활용해 인프라 특성에 따른 디버깅과 환경 설정을 완수한 사례이다.

유튜브 검색 최적화(SEO)를 위해 Claude Haiku 모델을 활용한 메타데이터 생성 기능을 통합했다. 사용자가 주제를 입력하면 Zapier의 SEO 가이드라인을 학습한 AI가 제목 3종과 상세 설명을 생성한다. 마크다운 형식을 제거하는 방어적 코드를 추가하여 API 응답의 일관성을 높였다. 전문 지식 없이도 고품질의 메타데이터를 생성하여 영상 노출 효과를 극대화한다.

근거

Claude Haiku를 사용하여 3개의 제목 옵션과 전체 설명을 생성한다. — Generating YouTube metadata with Claude 섹션 두 번째 문단

실제 운영 과정에서 유튜브의 2MB 썸네일 용량 제한으로 인한 업로드 오류를 발견하고 이를 자동 압축 로직으로 해결했다. sharp 라이브러리를 사용하여 용량이 초과된 이미지를 1280px 너비로 리사이징하고 품질을 단계적으로 낮춰 제한을 맞춘다. 사용자 경험을 개선하고 업로드 성공률을 높이는 필수적인 예외 처리를 구현했다. AI가 놓칠 수 있는 프로덕션 환경의 세부 제약 조건을 보완한 결과이다.

근거

유튜브는 썸네일 파일 크기를 2MB로 제한하고 있다. — Bug reports and feature requests from the team 섹션 첫 문단

용어 해설

오픈 인증 2.0(OAuth 2.0): — 사용자가 비밀번호를 직접 공유하지 않고도 제3자 앱에 자신의 데이터 접근 권한을 부여할 수 있게 하는 표준 프로토콜이다. 이 프로젝트에서는 직원 인증과 유튜브 채널 업로드 권한을 안전하게 분리하여 관리하는 핵심 보안 메커니즘으로 사용되었다.
갱신 토큰(Refresh Token): — 액세스 토큰이 만료되었을 때 사용자의 재로그인 없이 새로운 액세스 토큰을 발급받기 위해 사용되는 특수 토큰이다. 서버 재시작이나 세션 만료 시에도 업로드 권한을 유지하기 위해 이 토큰의 지속성을 확보하는 것이 기술적 난제 중 하나였다.
서비스형 플랫폼(PaaS): — 개발자가 인프라를 직접 관리하지 않고도 애플리케이션을 배포하고 실행할 수 있게 해주는 클라우드 컴퓨팅 서비스이다. 본문에서는 Render라는 플랫폼을 사용했으며, 서버가 수시로 재시작되는 특성 때문에 메모리 기반 데이터 저장의 한계가 드러났다.
검색 엔진 최적화(SEO): — 웹 콘텐츠가 검색 결과 상단에 노출되도록 제목, 설명, 태그 등을 최적화하는 기법이다. 유튜브 알고리즘에 맞춘 키워드 배치와 글자 수 제한을 준수해야 하며, 본 도구에서는 Claude Haiku가 이 과정을 자동화한다.

기술

Claude Code
Claude Haiku
Node.js
Express
Render
sharp
nodemailer
Anthropic API

활용 사례

사내 유튜브 업로드 자동화 시스템
AI 기반 콘텐츠 메타데이터 생성 도구
자가 서비스형 미디어 관리 워크플로

언급된 리소스

API DocsClaude API