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

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

Zapier의 영상 제작 민주화로 인해 급증한 유튜브 업로드 요청을 처리하기 위해 Claude Code를 활용하여 자동화 도구를 개발했다. 이 도구는 직원들이 채널 권한 없이도 직접 영상을 업로드할 수 있게 하며, Claude Haiku를 통해 SEO에 최적화된 제목과 설명을 자동으로 생성한다. 개발 과정에서 Render 호스팅 환경의 토큰 유지 문제와 썸네일 용량 제한 등 기술적 난관을 AI와의 협업으로 해결했다. 결과적으로 기획부터 업로드까지의 전 과정을 AI 기반의 자가 서비스 체계로 전환하여 운영 효율을 극대화했다.

배경

Node.js 및 Express 기초 지식, OAuth 2.0 인증 개념, 유튜브 API 및 Google Cloud Console 설정 방법

대상 독자

AI 도구를 활용해 업무 자동화 도구를 구축하려는 비전공자 및 개발자

의미 / 영향

이 사례는 AI 코딩 도구가 단순한 코드 작성을 넘어 아키텍처 설계와 인프라 디버깅까지 지원할 수 있음을 보여줍니다. 특히 전문 개발 인력이 부족한 팀에서도 LLM을 활용해 복잡한 API 연동 도구를 자가 구축함으로써 조직 전체의 생산성을 높일 수 있는 가능성을 제시합니다.

섹션별 상세

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

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

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

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

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

실무 Takeaway

Claude Code와 같은 AI 코딩 도구를 활용하면 비전공자도 복잡한 OAuth 인증과 API 연동이 포함된 실무용 도구를 빠르게 구축할 수 있다.
PaaS 환경에서는 서버 재시작에 따른 세션 및 토큰 휘발성 문제를 고려하여 환경 변수나 영구 저장소를 활용한 토큰 유지 전략을 수립해야 한다.
LLM API 응답에서 발생할 수 있는 불필요한 마크다운 코드 펜스 등을 제거하는 후처리 로직을 추가하여 시스템의 안정성을 확보하는 것이 중요하다.

언급된 리소스

API DocsClaude API