AI를 활용한 재밌는 것들을 개발합니다

2026년 4월 26일 일요일

YouTube 채널 분석기 만들기, 기획부터 완성까지 [Claude Code · 유튜브분석기 · 1편]

Claude Code Python 자동화 YouTube API

Claude Code로 유튜브 채널 분석기 만들기
— 기획부터 완성까지

코딩 경험 없어도 AI와 함께라면 가능합니다. 실제 개발 과정을 그대로 공개합니다.

왜 만들었나요?

저를 유튜브 콘텐츠를 기획하는 1인 사업자라고 가정한다면 Claude Code와 Python으로 YouTube 트렌드 분석을 자동화하기로 마음먹은 건 단순한 이유였습니다. 매주 "이번 주 뭐가 트렌드지?", "어떤 주제를 다뤄야 조회수가 나올까?"를 고민하면서 직접 유튜브를 뒤지는 게 너무 반복됐거든요.

그러다 문득 이런 생각이 들었습니다.

💡 "이거 자동화할 수 있지 않을까?"
매주 일요일 저녁, 자동으로 유튜브 인기 영상을 수집하고, AI가 트렌드를 분석해서 이메일로 보내준다면?

그래서 Claude Code를 열었습니다. 그리고 실제로 만들었습니다. 오늘 이 글에서 그 전 과정을 공유합니다.


Claude Code가 뭐죠?

Claude Code는 Anthropic이 만든 AI 코딩 도우미입니다. ChatGPT처럼 대화하면서 코드를 짜는데, 결정적으로 다른 점이 있어요.

구분일반 AI 챗봇Claude Code
파일 접근❌ 직접 못 함✅ 실제 파일 읽고 씀
코드 실행❌ 보여주기만✅ 직접 실행하고 결과 확인
프로젝트 관리❌ 대화로만✅ 폴더 구조 통째로 파악
에러 처리❌ 다시 물어봐야 함✅ 에러 보고 스스로 수정

쉽게 말해서, Claude Code는 내 컴퓨터 안에서 직접 코드를 짜고, 실행하고, 고치는 AI 개발자입니다.


어떤 시스템을 만들었나?

최종 완성된 시스템의 구조입니다.

[매주 일요일 20:00 자동 실행]
        │
        ▼
  FetchAgent      ← YouTube 탑 채널 인기 영상 수집
        │
        ▼
  AnalysisAgent  ← Gemini AI로 트렌드 분석 + 주제 추천
        │
        ▼
  ReportAgent    ← PDF 리포트 생성 (차트 포함)
        │
  ┌─────┴──────┐
  ▼             ▼
 Gmail 발송   Notion 저장

분석 대상 분야는 세 가지입니다:

  • 수익성 브랜드
  • 콘텐츠 수익화
  • 1인 사업 런칭

Claude Code에 어떻게 지시했나?

가장 중요한 부분입니다. 저는 먼저 CLAUDE.md라는 프로젝트 설명서 파일을 만들었어요. 이 파일 하나가 전체 개발의 설계도가 됐습니다.

CLAUDE.md란?
Claude Code가 프로젝트를 시작할 때 가장 먼저 읽는 파일입니다. 여기에 목적, 구조, 규칙을 적어두면 Claude가 그 맥락을 유지하며 개발합니다.

제가 Claude Code에 처음 입력한 내용은 이겁니다:

@CLAUDE.md 이 파일을 기반으로 프로젝트 초기화 해줘.

그랬더니 Claude Code가 혼자서 이런 작업을 했습니다:

  • 📁 agents/, tools/, tests/ 폴더 생성
  • 🐍 각 에이전트 파이썬 파일 생성
  • 📦 requirements.txt 작성
  • ⚙️ .env.example 환경변수 파일 생성
  • 🚀 main.py 진입점 생성

코드 한 줄 제가 직접 안 썼습니다.


개발 과정에서 실제로 겪은 것들

🔴 처음에 안 됐던 것 1: Anthropic API 비용 문제

처음에는 Claude API(Anthropic)로 분석을 돌리려고 했는데, 이 자동화 시스템에 매주 API 비용을 쓰는 건 비효율적이었습니다. 그래서 Gemini API(무료 티어)로 교체했습니다.

🔴 처음에 안 됐던 것 2: Gemini 모델 이름 오류

Gemini API를 연결했는데 계속 404 에러가 났습니다. 원인은 모델 이름이었어요:

# ❌ 안 됨
model="gemini-1.5-flash"

# ✅ 됨
model="gemini-2.5-flash"

Claude Code가 자동으로 에러를 분석하고 올바른 모델명으로 수정했습니다.

🔴 처음에 안 됐던 것 3: PDF 한글 깨짐

PDF를 생성했는데 한글이 전부 깨졌습니다. 처음엔 weasyprint → xhtml2pdf 를 시도했지만 Windows 환경에서 계속 에러. 결국 fpdf2 + 맑은 고딕 폰트 직접 삽입으로 해결했습니다. 이 내용은 3편에서 자세히 다룹니다.


최종 결과물

✅ 완성된 기능 목록

✔ 매주 일요일 20:00 자동 실행
✔ YouTube 3개 분야 인기 영상 수집
✔ Gemini AI 트렌드 분석 + 콘텐츠 주제 3개 추천
✔ 차트 3개 포함된 한글 PDF 리포트 생성
✔ Gmail로 PDF 자동 발송
✔ Notion에 주간 데이터 누적 저장

총 개발 시간: 하루. Claude Code와 함께라서 가능했습니다.


다음 편 예고

2편에서는 YouTube Data API 연동 코드 전체를 공개합니다. API 키 발급부터 실제 데이터 수집 코드까지 따라 할 수 있게 작성했습니다.

📌 이 시리즈 전체 목차
1편 ✅ Claude Code로 유튜브 채널 분석기 만들기 — 기획부터 완성까지 (현재 글)
2편 → 유튜브 Data API 연동 코드 전체 공개
3편 → Python으로 분석 결과 자동 이메일 발송하기
4편 → 실제 PDF 리포트 공개 + Ollama 로컬 AI 도전기

댓글 없음:

댓글 쓰기

가장 많이 본 글