moai run으로 유튜브 새 영상 감지 — 코드 0줄로 AI 자동화 봇 만든 후기 (2026)
moai run 한 줄이면 유튜브 새 영상 자동 감지 코드가 완성됩니다. moai plan으로 설계, moai run으로 구현까지 코드 한 줄 안 짜고 AI 봇을 만든 실제 경험을 공유합니다.
구독 채널이 10개만 넘어도, 새 영상 올라왔는지 확인하는 것부터가 일이죠. 유튜브 알림은 놓치기 쉽고, 직접 채널을 하나씩 들어가 보는 건 비효율 그 자체입니다. “이걸 자동으로 잡아주는 봇이 있으면 좋겠는데” 싶은 적, 다들 한 번쯤 있을 겁니다.
그래서 직접 만들어봤습니다. 정확히는, AI한테 시켜서 만들었습니다.
결론부터 말하면 — moai run 한 줄이면 유튜브 새 영상 감지 코드가 자동으로 완성됩니다. 코드를 한 줄도 안 짰는데 파일이 생기고, 실행하면 터미널에 새 영상 제목이 찍힙니다.
이 글에서는 moai plan으로 설계를 맡기고, moai run으로 코드를 자동 생성한 뒤, 실제로 새 영상 감지에 성공하기까지의 전 과정을 공유합니다. 에러가 났을 때 어떻게 대처했는지도 포함했으니, 따라 하다 막힌 분들께도 도움이 될 겁니다.
이전 편에서 API 키 3개 발급을 마쳤다면, 이 편을 바로 이어서 진행할 수 있습니다.
Plan → Run → Sync, 바이브 코딩의 3단계 워크플로우
moai-adk는 세 단계로 움직입니다. 사람이 하는 건 방향을 잡아주는 것뿐이고, 나머지는 AI가 처리합니다.
- moai plan — AI에게 “이런 기능 만들어줘”라고 말하면, SPEC 설계서를 자동으로 작성합니다. 뭘 만들지, 어떤 파일이 필요한지, 테스트는 어떻게 할지까지 정리해줍니다.
- moai run — SPEC 번호를 넘기면 28개 에이전트가 팀을 나눠서 코드를 구현합니다. 구현, 테스트, 품질 검증까지 자동입니다.
- 실행 확인 — 생성된 코드를 직접 돌려보고 결과를 확인합니다. 잘 됐으면 다음 기능으로 넘어갑니다.
이 흐름을 한 번 익히면, 나머지 기능도 똑같은 패턴으로 만들 수 있습니다. 바이브 코딩의 핵심 개념이 바로 이겁니다.
moai plan — AI에게 설계를 맡기다
먼저 프로젝트 폴더에서 Claude Code를 실행합니다.
cd youtube-summary-bot
claudeClaude Code가 켜졌으면 아래 명령어를 그대로 입력합니다.
/moai plan ".env의 YOUTUBE_CHANNEL_IDS에 등록된 채널들의 최신 영상을 YouTube Data API v3로 조회하고, 마지막 확인 시각 이후 새로 올라온 영상만 필터링해서 제목과 영상 URL을 출력하는 기능을 Python으로 만들어줘"1~2분 기다리면 AI가 SPEC 문서를 만들어줍니다. 내용은 대략 이렇습니다.
- SPEC-YT-001 : 유튜브 새 영상 감지 기능
.env에서 채널 ID 목록 읽기- YouTube Data API로 각 채널 최신 영상 조회
last_checked.json으로 마지막 확인 시각 관리- 새 영상만 필터링해서 제목 + URL 반환
- 테스트 시나리오 3가지 포함
설계서를 검토한 뒤 수정할 게 있으면 채팅창에 바로 말하면 됩니다. AI가 즉시 반영해줍니다. 문제없으면 다음 단계로 넘어갑니다.
아직 Claude Code와 moai-adk가 설치 안 됐다면, 설치 가이드부터 진행하세요.
moai run — 첫 실행, 진짜 돌아갈까?
SPEC 번호를 확인했으면 run 명령어로 실제 구현을 시작합니다.
/moai run SPEC-YT-00128개 에이전트가 팀을 나눠서 움직이기 시작합니다. 3~5분 정도 걸리고, 터미널에 진행 상황이 실시간으로 표시됩니다.
🗿 MoAI Orchestrator → analyzing SPEC-YT-001
↳ spec-agent: reading requirements...
↳ backend-agent: planning implementation...
↳ backend-dev: writing youtube_checker.py
↳ backend-dev: writing config.py
↳ tester: writing test_youtube_checker.py
↳ quality-agent: running TRUST 5 validation...
✓ Tests passed (3/3)
✓ Lint passed
🎉 SPEC-YT-001 complete!완료되면 프로젝트 폴더에 파일들이 생겨 있습니다. 코드를 한 줄도 안 짰는데요.
자동 생성된 파일 목록:
| 파일명 | 역할 |
|---|---|
youtube_checker.py | 채널 새 영상 감지 메인 코드 |
config.py | .env 파일 읽어오는 설정 |
last_checked.json | 마지막 확인 시각 저장 |
test_youtube_checker.py | 테스트 코드 (자동 생성) |
실행 결과 확인하기 — 새 영상 감지 성공!
코드가 생겼으니 실제로 돌려봅니다. Claude Code 밖에서 새 터미널 탭을 열고 아래 명령어를 실행합니다.
pip install -r requirements.txt
python youtube_checker.py처음 실행이라 last_checked.json이 없으면 최근 영상 몇 개가 전부 출력됩니다. 이건 정상입니다.
Checking channels for new videos...
✓ Channel: 침착맨
[NEW] 오늘의 방송 하이라이트
→ https://youtube.com/watch?v=xxxxxxx
✓ Channel: 드로우앤드류
[NEW] 요즘 제 루틴이 바뀐 이유
→ https://youtube.com/watch?v=yyyyyyy
Done. 2 new video(s) found.구독 채널의 새 영상 제목이 터미널에 뜨는 걸 보는 순간, 진짜 소름 돋습니다. 코드 한 줄 안 짰는데 이게 된다는 게 바이브 코딩의 핵심 경험입니다.
여기까지 핵심 정리:
/moai plan "기능 설명"→ AI가 SPEC 설계서 자동 작성/moai run SPEC-번호→ AI가 코드 자동 구현 + 테스트까지python youtube_checker.py→ 구독 채널 새 영상 제목 출력
다음 편에서는 감지된 영상을 Claude가 직접 요약하는 기능을 붙입니다. 자막이 있으면 자막으로, 없으면 설명으로 자동 판단합니다.
에러가 났을 때 대처법 (실제 경험)
처음부터 깔끔하게 되면 좋겠지만, 실제로는 에러가 나는 경우도 있습니다. 제가 겪은 케이스와 해결법을 공유합니다.
SPEC 번호가 다르게 나왔을 때 — moai가 자동으로 번호를 붙이기 때문에 SPEC-YT-001이 아닌 다른 번호가 나올 수 있습니다. plan이 끝나면 터미널에 표시되는 번호를 그대로 /moai run 뒤에 붙이면 됩니다.
moai run 후 파일이 안 보일 때 — Claude Code 안에서 ls -la로 확인해보세요. 파일이 없다면 “SPEC-YT-001 구현이 완료됐나요?”라고 물어보면 상황을 파악해줍니다. 대부분 /moai run을 다시 실행하면 해결됩니다.
ModuleNotFoundError가 날 때 — pip install -r requirements.txt를 빠뜨린 경우가 대부분입니다. 그래도 안 되면 에러 메시지를 Claude Code에 그대로 붙여넣고 “이 에러 어떻게 고쳐요?”라고 물어보세요. AI가 바로 해결책을 알려줍니다.
에러가 나더라도 당황하지 마세요. 바이브 코딩의 장점은, 에러 해결조차 AI한테 물어보면 된다는 겁니다.
자주 묻는 질문 (FAQ)
Q. moai run 실행하면 얼마나 걸리나요?
보통 3~5분 정도 걸립니다. SPEC의 복잡도에 따라 다르지만, 새 영상 감지 기능 정도는 5분을 넘기지 않습니다. 터미널에 진행 상황이 실시간으로 표시되니 기다리면서 지켜보면 됩니다.
Q. moai plan이 만든 코드를 수정해도 되나요?
물론입니다. 자동 생성된 코드는 일반 Python 파일이라 자유롭게 수정할 수 있습니다. 다만 수정 후 다시 /moai run을 돌리면 덮어쓸 수 있으니, 수정본은 별도로 백업해두는 게 좋습니다.
Q. 새 영상이 아닌 기존 영상도 가져오나요?
처음 실행할 때는 last_checked.json이 없어서 최근 영상 여러 개가 한꺼번에 출력됩니다. 이건 정상입니다. 두 번째 실행부터는 마지막 확인 시각 이후에 올라온 영상만 필터링됩니다.
Q. moai run 에러가 나면 어떻게 하나요?
에러 메시지를 Claude Code 채팅창에 그대로 붙여넣으세요. “이 에러 어떻게 해결해요?”라고 물어보면 AI가 원인 분석과 해결책을 바로 알려줍니다. 대부분의 에러는 환경 설정 누락이나 의존성 문제라 금방 해결됩니다.
Q. YouTube API 할당량 초과하면?
YouTube Data API v3의 일일 할당량은 10,000 유닛입니다. 채널 새 영상 조회는 건당 약 100 유닛을 소모하므로, 채널 10개 기준으로 하루 100번 이상 실행할 수 있습니다. 개인 용도로는 충분합니다. 할당량이 초과되면 429 에러가 나는데, 다음 날 자정(태평양 시간)에 자동 리셋됩니다.
시리즈 전체 보기
- 0편 바이브 코딩이 뭔데? 개념부터 정리
- 1편 Claude Code + moai-adk 설치 가이드
- 2편 API 키 3개 발급받기
- 3편 moai run으로 새 영상 감지 구현 ← 지금 읽고 있는 글
- 4편 Claude가 영상을 요약해주는 기능
- 5편 슬랙 DM으로 요약 받기 — 완성
- 6편 바이브 코딩 솔직 후기
코드 한 줄 안 짰는데 유튜브 새 영상 감지가 된다는 게 아직도 신기합니다. 이게 바이브 코딩의 진짜 맛이에요. 다음 편에서는 감지된 영상을 Claude가 직접 요약해주는 기능을 붙입니다. 자막이 있으면 자막으로, 없으면 설명으로 — AI가 알아서 판단합니다.
다음 글도 곧 찾아옵니다!
빌더 론
인프라 엔지니어 출신, AI와 자동화로 시스템을 만드는 블로거입니다.
