14개 에이전트가 나눠 맡는 유튜브 쇼츠 자동화

"다 만들어"라고 한마디 하면, 소재 발굴부터 유튜브 예약 업로드까지 16분 만에 끝납니다.

내용이 조금 깁니다. 관심 있으신 분은 천천히, 참고만 하실 분들은 가볍게 읽어보시면 됩니다.

쇼츠 하나를 만들려면 주제 선정부터 영상 제작, 자막, 업로드까지 작업이 이어집니다. 이 글에서는 Claude Code 에이전트 14개가 그 흐름을 나눠 맡아 소재 발굴부터 유튜브 예약 업로드까지 처리하는 파이프라인을 살펴봅니다.

이 글에서는 제가 러프하게 만든 인디 앱 소개 채널을 예시로 듭니다. 앱 아이콘을 3D 캐릭터로 바꿔 자기소개를 시키는 쇼츠를 만들었지만, 채널 주제보다 자동화 구조를 봐야 합니다. 에이전트 14개가 소재 발굴부터 유튜브 예약 업로드까지 맡고, 주제만 바꾸면 다른 반복 포맷에도 같은 구조를 적용할 수 있습니다. 반복 작업은 파이프라인이 대신하고, 어떤 주제를 어떤 관점으로 다룰지는 창작자가 정합니다. 결국 채널을 다르게 만드는 것은 여러분이 가진 도메인 지식입니다.

코드 한 줄씩 따라가는 글은 아닙니다. 전체 흐름과 설계 원리를 보면서 "이런 식으로 돌아가는구나"를 확인하는 글입니다. 자기 도메인에 맞게 바꾸는 일은 그다음에 Claude Code에게 맡기면 됩니다.

요리 레시피 채널, 뉴스 요약 채널, 제품 리뷰 채널, 운동 루틴 채널 — 반복되는 포맷이 있는 콘텐츠라면 이 구조가 잘 맞습니다.

채널 주제가 달라도 소재 선정부터 예약 업로드까지 같은 순서를 반복한다면, 이 구조를 주제에 맞게 바꿔 쓸 수 있습니다.

14개 에이전트가 4개 Phase로 쇼츠 작업을 나눕니다

먼저 큰 그림부터 보면, 파이프라인은 4단계로 나뉘고 하나의 마스터 에이전트(batch-orchestrator)가 전체 흐름을 제어합니다.

소재 선정부터 업로드까지, 13강에서 다룬 "복잡한 작업은 단계별로 나누라"는 원칙을 적용한 구조입니다.

사람이 매 단계의 결과를 직접 확인하지는 않습니다. 에이전트가 정해 둔 기준으로 중간 결과를 확인한 뒤 다음 단계로 넘어갑니다.

API 키·YouTube OAuth·저장소와 중단 작업을 먼저 확인합니다

생성을 시작하기 전에, 마스터 에이전트가 필요한 환경부터 확인합니다.

• API 키가 설정되어 있는지 (이미지·영상 생성용)

• YouTube OAuth 토큰이 유효한지 (업로드용)

• 저장소 연결이 살아 있는지 (에셋 저장용)

• 이전 실행에서 멈춘 작업이 있으면 초기화

이 파이프라인은 12강에서 다룬 MCP 연결 방식 대신 REST API를 직접 호출합니다. MCP는 Claude Code가 대화 중 도구를 쓸 때 편하고, 자동화 파이프라인에서는 Python 스크립트로 API를 직접 호출하는 편이 더 안정적이기 때문입니다.

점검이 끝나면 이미 만들어 둔 에셋이 있는지도 확인합니다. 이전 실행이 이미지를 만든 뒤 멈췄다면, 처음부터 다시 만들지 않고 영상 생성부터 이어 갑니다.

소재 하나는 6개 에이전트가 순서대로 처리합니다

Phase 1이 가장 복잡합니다. 쇼츠 하나에 넣을 소재 하나를 처리할 때 에이전트 6개가 순서대로 작업합니다. 이 6단계 파이프라인은 N개(보통 4개)가 동시에 실행됩니다.

이 예시의 흐름은 "인디 앱 → 3D 캐릭터 → 자기소개 영상"입니다. "레시피 선정 → 재료 이미지 → 조리 영상"이나 "뉴스 기사 → 요약 스크립트 → 나레이션 영상"으로 바꿔도 단계가 연결되는 방식은 같습니다.

1단계: 소재 선정 — idea-picker

첫 번째로 정할 것은 소재입니다. ProductHunt API로 인디 앱을 찾되, 아무 앱이나 고르지 않습니다.

지금까지 만든 영상의 테마 분포를 보고, 가장 적게 다룬 분야를 먼저 고릅니다. 노트 앱만 계속 나오면 재미없기 때문입니다.

테마를 정한 뒤에는 해당 분야의 앱 30개를 가져와 필터링합니다.

• 투표 수 100~2,000 사이 (너무 유명하지도, 너무 무명이지도 않은 인디 앱)

• 팀 규모 5명 이하