Claude Code로 YouTube 댓글 20개 브리핑 봇 만들기

댓글창을 붙잡고 있지 않아도 되는 흐름
이번 글에서 만드는 건 YouTube 댓글 브리핑 봇이다. 내 영상에 달린 최근 댓글 20개를 읽고 분위기 한 줄, 자주 나온 질문 3개, 바로 답글 달기 좋은 댓글 2개를 텔레그램 6줄 안으로 묶어 보내는 방식이다. 영상 하나 올리고 나면 반응이 궁금해서 댓글창을 몇 번씩 열게 되는데, 이 자동화는 그 시간을 줄여준다. 이동 중에 폰으로 핵심만 먼저 보고, 집에 돌아와서 답글을 달아도 흐름이 끊기지 않는다.
포인트는 기능을 잔뜩 붙이는 게 아니다. Claude Code에서 /init으로 작업 규칙을 먼저 고정하고, plan mode로 읽기 전용 계획을 세운 다음, app.py 한 파일에서 첫 결과를 5분 안에 확인하는 데 집중하면 된다. 텔레그램 연결은 그다음에 얹으면 된다. 처음부터 스케줄러나 데이터베이스까지 가져오지 않아도 한 번 실행해서 브리핑이 도착하면 이미 쓸 만한 자동화가 된다.
필요한 건 키 두 개와 영상 ID 하나다
도구는 Claude Code 기준으로 설명한다. 댓글 조회는 YouTube Data API가 맡고, 알림 수신은 텔레그램 봇이 맡는다. 여기에 videoId만 바꿔 넣으면 다른 영상에도 그대로 돌릴 수 있다. 반복해서 확인하던 수작업을 줄이기에 딱 좋은 조합이다.
Claude Code를 처음 써도 오늘은 복잡하게 갈 필요가 없다. 필요한 건 /init과 plan mode 두 가지다. /init은 이 폴더에서 어떤 기준으로 작업할지 적어두는 출발점이고, plan mode는 곧바로 파일을 건드리지 않고 흐름을 먼저 정리하는 단계다. 초보가 편한 이유도 여기 있다. 손보다 눈이 먼저 정리되고, 파일 수가 갑자기 불어나지 않는다.
여기서는 멋진 문장을 뽑아내는 것보다 작업 범위를 분명하게 만드는 쪽이 중요하다. 나중에 텔레그램 메시지를 다듬을 때도 이 메모가 계속 기준이 된다. 초보 입장에서는 이 기준선 하나가 생각보다 크다.
이 프롬프트가 좋은 이유는 해야 할 일을 작게 보이게 만들기 때문이다. videoId 입력, 최근 반응 20개 조회, 질문 3개 추리기, 콘솔 출력까지 순서가 눈에 들어오면 갑자기 만만해진다. app.py와 .env.example만 제안하라고 못 박아두면 시작부터 옆길로 새는 일도 줄어든다.
여기서 확인할 건 복잡한 설계가 아니다. 숫자와 순서가 또렷한지만 보면 된다. 20개, 3개, 6줄이 흐려지면 다시 지정해주면 되고, plan mode에서는 코드보다 흐름 정리에 집중하면 된다.
여기서는 속도가 중요하다. 콘솔에 6줄 브리핑이 한 번만 떠도 자동화의 골격이 손에 잡히기 시작한다. 영상 ID를 넣고 실행했을 때 분위기 한 줄과 질문 3개, 답글 후보 2개가 정리돼 나오면 다음 단계로 넘어갈 준비가 끝난 셈이다.
문장이 조금 투박해도 괜찮다. 더 중요한 건 데이터가 실제로 읽히고, 20개 반응 중에서 무엇을 남길지 기준이 생기는 일이다. 질문이 이상하게 뽑히면 제외 대상을 더 적어주면 된다. 이모지만 있는 반응은 빼고 문장형 질문을 우선 보라고 한 줄만 더해도 결과가 꽤 달라진다.
이 단계부터는 진짜 생활 자동화가 된다. 텔레그램으로 받아보는 것만으로도 편하지만, 오래 쓰게 만드는 건 중복 방지다. 같은 댓글을 다음 실행 때 또 읽어서 똑같은 알림을 보내면 금방 꺼버리게 된다. 마지막 댓글 시간이나 ID를 작은 json 파일에 저장하는 이유가 바로 여기에 있다.
실행 명령을 python app.py 한 번으로 유지하라는 조건도 초보에게 중요하다. 파일이 늘어나거나 명령이 갈라지는 순간 부담이 확 커진다. 한 번 실행해서 브리핑이 오고, 다음 실행에서는 새 반응만 반영되면 일상에서 계속 쓰기 쉬운 형태가 된다.
자동화가 돌아가도 문장이 어색하면 자주 안 쓰게 된다. 그래서 마지막에 말투를 손보는 요청이 꼭 들어가야 한다. 짧게 끊고, 보고서 같은 표현을 줄이고, 답글 예시 2개를 바로 복붙할 수 있게 만들면 알림을 읽는 순간 다음 행동까지 이어진다. README 8줄 이내 조건도 실전에서 꽤 중요하다. 설명이 길어지는 순간 다시 손이 멈추기 쉽다.
막히는 지점은 보통 세 군데다
첫 번째는 403 같은 권한 오류다. 조회 단계에서 바로 멈추거나 videoId는 맞는데 빈 배열이 나오면 YouTube Data API 설정부터 보는 편이 빠르다. API가 켜져 있는지, 키 앞뒤에 공백이 없는지, 키 제한이 너무 좁지 않은지 확인하면 정리되는 경우가 많다.
두 번째는 요약 품질이다. 20개를 읽었는데 감탄사만 남거나 질문 3개가 흐릿하면 프롬프트 기준이 약한 경우가 많다. 이모지만 있는 반응은 제외하고, 실제로 답글을 달 만한 질문을 문장형으로 뽑아달라고 적어주면 읽는 맛이 달라진다.
세 번째는 알림 중복이다. CHAT_ID가 잘못됐거나 마지막 댓글 ID를 저장하는 json 파일이 갱신되지 않으면 같은 내용이 반복될 수 있다. 파일이 실제로 생겼는지, 새 실행 뒤 값이 바뀌는지만 확인해도 원인을 빨리 좁힐 수 있다.
이 봇이 괜찮은 이유는 다음 영상까지 이어지기 때문이다
YouTube 댓글 브리핑 봇을 여기까지 만들면 댓글 확인 자동화는 끝난다. 그다음에는 자주 나온 질문 3개 중 하나를 골라 Shorts 아이디어 한 줄로 바꾸게 붙이면 된다. 그러면 반응 목록이 그냥 쌓이는 게 아니라 다음 콘텐츠 기획의 재료로 바뀐다. 영상 하나 올리고 반응을 모은 뒤, 다음 기획으로 넘어가는 흐름이 여기서 자연스럽게 이어진다.
처음부터 거대한 시스템으로 갈 필요는 없다. app.py 한 파일, 댓글 20개, 텔레그램 6줄, 답글 후보 2개. 이 정도만 먼저 돌아가도 손으로 하던 반복이 꽤 많이 줄어든다. Claude Code는 이럴 때 특히 편하다. 규칙을 먼저 적어두고, plan mode로 작게 쪼개고, 첫 결과를 빨리 보는 흐름만 지켜도 초보가 끝까지 가져가기 쉬운 자동화가 나온다.
이런 글도 있어요
관련 검색어
- 🔍 Claude Code 사용법
- 🔍 Claude Code 비교
- 🔍 유튜브 댓글 요약 사용법
- 🔍 유튜브 댓글 요약 비교
- 🔍 텔레그램 봇 사용법
- 🔍 텔레그램 봇 비교