🎯 LMS 다시보기 자막 추출하다 ip 벤 당한 썰

📖 소개

안녕하세요 프리랜서 자동화 스터디장 진여진입니다 🙇‍♂️

LMS 주차 별 다시보기를 제공 받는데

잘 활용 못하는게 아쉬워서 자동화를 구현합니다.

템플릿에 제공된 youtube-collector skill 을 재활용하면 금방 해낼 것 같기도 하고

때마침 다혜님이 LMS 다시보기 링크도 제공 해드렸으니 개발은 더 편해지겠네요 ㅎㅎ

템플릿 소개

ALT

파일 목록을 보여주는 웹 페이지의 스크린샷

수강생을 위해 클로드 코드 환경만 가능한 템플릿이구요,

Github 에 오픈소스로 업로드 했습니다

2주차 수업 (01/20 화, 밤 9시) 까지 오픈소스로 게시 후 닫을 예정입니다.

https://github.com/YeoulHi/gpters-20th-duwls-templates

💭 해결 아이디어

"YouTube 영상의 자막을 자동으로 추출해서 정리하면 어떨까?"

• 영상 URL → 자막 텍스트 자동 추출

• 추출한 자막을 로컬에 저장

• 학습용 템플릿에 있는 youtube-collector skill 을 재활용

🎯 초기 목표

✅ YouTube 자막 수집 자동화 ✅ 스터디 동료들도 쓸 수 있는 코드 공유

🛠️ 진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?

• /setup-workspace : CLAUDE.md 의 기본적으로 참고해야 할 정보를 작성합니다

• /clarify : 요구사항을 정의사항 정의를 돕는 인터뷰어입니다.

• /plan : Claude Code 기본 기능 + Plan 에이전트를 이용합니다.

0단계 : /setup-workspace

학습용 템플릿은 스터디장이 미리 만들어 둔 커스텀 명령어와 기타 참고자료들이 있습니다

1단계 : /Clarify

ALT

주황색 화면이 표시된 컴퓨터 화면의 스크린샷

이후 적절히 대화 나누면서 진행했습니다

그 중 대화를 나누면서 아래의 맥락을 말했습니다.

이게 엄청난 스노우볼이 될지는 예상 못했습니다 ;;

지피터스 스터디원에게도 도움이 되는 사례여야한다. 
따라서 조금 더 범용적으로 사용할 수 있는 유연한 코드를 지향한다 

처음 설계 (문제 발생)

/clarify 이후 설계 문서를 보는데 이 정도로 문서를 작성 할 필요가 없는데

문서가 많아서 뭔가 이상했습니다.

문제: "스터디 사례를 만들기 위한" 설계로 시작
↓
결과: 코드 베이스가 필요 이상으로 복잡하게 됨
↓
깨달음: 기술적 요구사항과 실제 목표가 다름

Claude와의 대화:

"clarify 명령어로 요구사항을 정리했는데, 실제로는 단순한 자막 수집만 필요했어요"

배운 점: AI가 단순히 코드만 짜는 게 아니라, 설계 단계에서 요구사항 자체를 점검해줄 수 있다는 것

2단계: 재설계 (단순화)

초기 복잡한 설계를 다시 정의:

현재 아주 간단한 기능만 원하기 때문에, skill 의 코드 맥락만 참고해서

다시 구현하는게 나은 상황입니다.

필요한 것

• Python 스크립트로 YouTube URL 입력

• 자막을 텍스트 파일로 저장

불필요한 것

• 복잡한 데이터베이스 구조

• 웹 인터페이스

3단계: 환경 설정 (venv)

ALT

한국어 프로그램 스크린샷

Claude의 조언대로:

# Python 가상환경 생성
python -m venv venv

![alt text](<Pasted image 20260115201811.png>)

# 활성화 (Windows)
venv\Scripts\activate

# 라이브러리 설치
pip install youtube-transcript-api

왜 venv를 썼나요?

"프로젝트마다 다른 라이브러리 버전을 쓸 수 있어요. 한 프로젝트의 업데이트가 다른 프로젝트를 망치지 않습니다"

추가 : API 발급 어떻게 하는지도 물어봄

비상 : 라이브러리 버전 이슈 진단 (핵심!)

문제 상황

AttributeError: module 'youtube_transcript_api' has no attribute '__version__'

Claude가 한 일

1. 에러 메시지 분석: 어느 라이브러리에서 문제인지 파악

2. 버전 호환성 확인: 레거시 라이브러리가 최신 YouTube 정책(IP 차단)을 반영하지 못함

3. 해결책 제시: 올바른 버전 명시 → requirements.txt 업데이트

배운 점

API 메서드 이슈로 AI 가 문제를 해결하고 API 통신을 요청을 무한 루프로 도니까

IP 벤을 당하더라구요 이런거 처음 당했습니다 ;;

"오픈소스 라이브러리는 시간이 지나면 작동 안 할 수 있다는 걸 몸으로 배웠어요"

📊 결과와 배운 점

✅ 최종 결과물

ALT

Adobe Adobe Adobe 광고의 한국어 스크린샷

사진에 보이시는 것처럼 추출 자체는 이제 잘 됐습니다~

🎓 배운 가장 중요한 3가지

1️⃣ 설계 단계에서 AI에게 질문하기

• ❌ 틀린 방법: "코드 짜줘"

• ✅ 맞는 방법: "이 요구사항이 맞나요?" → Claude와 함께 단순화

• 결과: 불필요한 복잡도 제거, 유지보수 쉬운 코드

2️⃣ 라이브러리 버전 관리의 중요성

• venv로 프로젝트 격리

• requirements.txt에 버전 명시 (예: youtube-transcript-api==1.2.3)

• 정기적으로 라이브러리 업데이트 확인

3️⃣ 테스트 코드로 빠르게 검증하기

• 전체 시스템을 다 만들기 전에 핵심 기능 테스트

• 하나의 URL로 먼저 확인 후 배치 처리 진행

• 오류를 조기에 발견 → 시간 절약

💬 재사용 가능한 프롬프트

1. "설계 단계에서 요구사항 점검"

[당신이 하고 싶은 일 설명]

이 작업에서 정말 필요한 기능이 뭘까요?
단순하게 정리해줄 수 있나요?

Claude의 역할: 요구사항 정리, 불필요한 부분 제거

2. "라이브러리 에러 진단"

[에러 메시지 붙여넣기]

이 에러가 뭐고, 어느 부분에서 문제인가요?
해결 방법이 뭔가요?

Claude의 역할: 에러 분석, 버전 확인, 대체 라이브러리 추천

3. "Python 환경 설정 안내"

Windows에서 Python 자동화를 처음 시작하는데,
venv 설정부터 라이브러리 설치까지 단계별로 알려줄 수 있나요?

Claude의 역할: 명확한 단계별 가이드 제공

📚 도움 받은 글 & 참고 자료

📖 문서

• CLAUDE.md: 4주 자동화 프로젝트 프레임워크

🔧 사용한 기술

• Python 3.11+

• youtube-transcript-api 1.2.3 (버전 명시 중요!)

• Claude Code (설계 + 테스트 + 문제 해결)

💡 다음 단계

• 외주 개발 플랫폼 이력서 작성

🚀 후기

"처음엔 '자동화 스크립트만 만들면 되겠지'라고 생각했는데, Claude와 함께 설계 단계부터 다시 고민하면서 훨씬 깨끗한 코드를 만들 수 있었어요.

특히 라이브러리 버전 문제를 함께 진단하면서 '단순히 코드가 아니라, 문제 해결 과정 자체를 배웠다'는 생각이 들었습니다.

앞으로는 외주 개발자의 userflow를 기록해서 불편한 부분을 효율적으로 자동화할 계획입니다."

작성: 진여진 (지피터스 20기 클코자동화 스터디장)

날짜: 2026-01-16