라핀이 만드는 AI 유튜브 자막 분석 프로그램 | Apify + Gemini로 벤치마킹 자동화
유튜브 영상의 자막을 자동으로 추출하고 AI로 분석하는 프로그램을 코딩 지식 없이 만들 수 있습니다. 라핀이 Apify YouTube Transcript Scraper와 Gemini API를 조합해 바이브코딩으로 완성하는 전 과정을 이 글에서 다룹니다.
Apify란 무엇인가?
Apify는 웹 스크래핑 자동화 플랫폼으로, '액터(Actor)'라는 다양한 데이터 수집 도구를 클라우드에서 실행할 수 있습니다. 틱톡 스크래퍼, 구글 맵 스크래퍼, 인스타그램 스크래퍼 등 수백 가지 액터를 제공하며, 가입 시 매월 $5 무료 크레딧을 제공합니다. 신용카드 없이 가입 가능하며, 무료 플랜은 4GB RAM과 7일 데이터 보관을 포함합니다.
유튜브 API는 조회수·좋아요·구독자 수 같은 메타데이터는 가져올 수 있지만, 자막 추출은 별도 라이브러리가 필요해 복잡합니다. Apify의 YouTube Transcript Scraper 액터를 활용하면 URL 입력만으로 자막을 손쉽게 가져올 수 있습니다.
준비물: Gemini API 키 + Apify 토큰 발급 방법
Gemini API 키 발급:
- Google AI Studio 접속
- 좌측 상단 'Get API Key' 클릭
- '+ API 키 만들기' → 프로젝트 선택 → 키 생성
- 발급된 키를 메모장에 별도 저장
Apify 토큰 발급:
- Apify.com 가입 (Google 계정 연동 가능)
- 좌측 하단 Settings → API & Integrations 클릭
- API 토큰 복사 후 메모장에 저장
- Apify Store에서 'YouTube Transcript Scraper' 검색 → 두 번째 액터 선택
- 해당 액터의 Information 탭에서 문서 전체 복사 (Claude에 제공할 참고 자료)
비용 계산: YouTube Transcript Scraper는 1,000회 요청에 $7입니다. 무료 크레딧 $5로 약 700회 무료 사용 가능합니다.
AI 자막 분석 프로그램 바이브코딩으로 만드는 법
라핀은 Claude Sonnet 4.5를 사용해 아래 프롬프트로 코딩을 시작했습니다.
핵심 프롬프트 구성 요소:
- 유튜브 링크 입력 → 자막 추출 → AI 가공 후 결과 출력하는 HTML 프로그램
- 한 줄 요약 + 핵심 내용을 초등학생도 이해할 수 있게 정리
- Gemini 2.0 Flash 모델 활용 (최신 모델명 검색 후 적용)
- Apify 액터 문서를 참고 자료로 첨부
- Gemini API 키와 Apify 토큰을 설정에서 저장 가능하게 구현
중요: 프롬프트에 어떤 도구를 사용할지, 어떻게 작동할지, 어떤 결과물이 나올지를 명확히 설명해야 Claude나 GPT가 원하는 프로그램을 만들 수 있습니다.
F12 콘솔로 에러 해결하는 방법
API가 포함된 HTML 파일은 Claude 아티팩트에서 직접 실행하면 CORS 오류가 발생합니다. 반드시 로컬에 저장 후 실행해야 합니다.
에러 발생 시 해결 순서:
F12키 → 콘솔(Console) 탭 열기- 빨간색 오류 메시지 전체 복사
- Claude에 붙여넣기 → "아래 콘솔 오류 확인 후 코드 개선해줘" 요청
- 수정된 코드를 HTML 파일에 덮어쓰기 (메모장 우클릭 → 편집)
- 재실행
이 과정을 2~3회 반복하면 대부분의 에러가 해결됩니다. API 키는 설정에 한 번 입력하면 저장되어 재사용 가능합니다.
자막 요약기 → 벤치마킹 분석기로 변형하는 방법
완성된 자막 요약 프로그램은 프롬프트 한 줄 변경으로 유튜브 벤치마킹 분석기로 확장할 수 있습니다.
벤치마킹 분석 프롬프트:
해당 영상을 유튜브 전문가 관점에서 분석해줘. 요약 대신 훅, 대본 구조, 화법, 스토리텔링 기법, CTA, 키워드 관점에서 각각 평가하고, 마지막에 개선 가능한 포인트도 알려줘.
분석 항목:
- 훅(Hook): 도입부 시청 유지 전략
- 대본 구조: 영상 흐름과 구성 방식
- 화법: 말하는 방식과 전달력
- 스토리텔링: 서사 구조와 감정 연결
- CTA: 구독·좋아요·댓글 유도 방식
- 키워드: 검색 최적화 관련 표현
- 개선 포인트: 더 나은 영상을 위한 제안
자막 분석기 + 유튜브 검색기 = 토탈 솔루션
이전 영상에서 소개한 유튜브 알고리즘 탄 영상 검색 프로그램과 오늘의 자막 분석기를 합치면 강력한 토탈 솔루션이 완성됩니다.
| 단계 | 기능 | 활용 도구 |
|---|---|---|
| 1단계 | 알고리즘 탄 영상 자동 검색 | YouTube API |
| 2단계 | 영상 자막 자동 추출 | Apify Transcript Scraper |
| 3단계 | 패턴 분석 + 기획안 생성 | Gemini/Claude AI |
| 4단계 | 내 채널용 스크립트 생성 | Gemini/Claude AI |
코딩을 몰라도 이 과정을 바이브코딩으로 직접 구현할 수 있습니다.
자주 묻는 질문 (FAQ)
Q. Apify 무료 크레딧 $5로 실제로 얼마나 사용할 수 있나요?
A. YouTube Transcript Scraper 기준으로 1,000회 요청에 $7이므로, $5 무료 크레딧으로 약 700개 영상의 자막을 추출할 수 있습니다. 매월 초기화되므로 개인 사용 수준에서는 사실상 무료로 활용 가능합니다.
Q. Gemini API는 무료인가요?
A. Google AI Studio에서 발급하는 Gemini API는 무료 티어를 제공합니다. Gemini 2.0 Flash 기준 분당 15회 요청, 하루 1,500회 요청이 무료입니다. 개인 프로젝트 수준에서는 비용 없이 사용할 수 있습니다.
Q. Claude 아티팩트에서 바로 실행하면 안 되나요?
A. API 키가 포함된 프로그램은 Claude 아티팩트에서 실행 시 CORS 정책으로 인한 오류가 발생합니다. 코드를 HTML 파일로 저장한 후 브라우저에서 직접 열어야 정상 작동합니다.
Q. 에러가 계속 반복될 때 어떻게 해야 하나요?
A. F12 콘솔에서 오류 메시지를 복사해 Claude에 붙여넣고 "콘솔 오류 확인 후 코드 개선해줘"라고 요청하면 됩니다. 대부분 2~3회 반복으로 해결됩니다. API 키는 코드에 직접 넣지 말고 설정 화면에서 입력하도록 구현해 보안을 유지하세요.
정리
| 도구 | 역할 | 비용 |
|---|---|---|
| Apify YouTube Transcript Scraper | 유튜브 자막 추출 | 월 $5 무료 크레딧 제공 |
| Gemini API (Google AI Studio) | AI 분석·요약·벤치마킹 | 무료 (하루 1,500회) |
| Claude Sonnet 4.5 | 바이브코딩으로 HTML 프로그램 생성 | 유료 (Claude Pro) |
| F12 콘솔 | 에러 디버깅 | 무료 (브라우저 기본) |
라핀의 바이브코딩 방식으로 코딩을 몰라도 유튜브 자막 분석 프로그램을 직접 만들 수 있습니다. 이전 영상의 유튜브 검색기와 합치면 콘텐츠 기획부터 스크립트 생성까지 AI 자동화 토탈 솔루션이 완성됩니다.
