Claude Code 활용해 당근 무료나눔 알림봇 1시간 만에 만들기

2026-06-12

매일 쏟아지는 무료나눔 물건을 누구보다 빠르게 가져오는 법

터미널 코딩 에이전트와 텔레그램 메신저만 있으면 됩니다

자동화 시스템을 구축하는 과정은 직관적입니다. 윈도우 환경의 터미널(PowerShell)에 Node.js가 깔려 있어야 하며, 인공지능 모델 기반의 전용 개발 도구 설치가 필요합니다. 터미널 환경에서 npm install -g @anthropic-ai/claude-code를 구동하고 claude 명령어를 사용하면 개발 준비가 끝납니다.

이 솔루션은 API 호출에 기반하여 작동하므로 사용량에 따른 비용 결제를 위해 해외 결제 수단을 사전에 등록해야 합니다. 국내 간편결제 서비스는 직접 연동하기 어려우므로 일반적인 신용카드를 권장합니다. 메시지를 수신할 통로로는 연동이 편리하고 개인용 봇 생성이 무료인 모바일 메신저 앱을 활용합니다.

5분 만에 당근마켓 나눔 게시판 글 긁어오기

우선 기본적인 데이터 수집 단계를 구현합니다. 터미널 대화창에 다음의 프롬프트를 입력하여 필요한 스크립트 제작을 지시합니다. "Playwright 라이브러리를 사용해서 당근마켓 웹사이트의 무료나눔 페이지 내용을 수집하고, 최신 글들의 제목과 가격 정보를 화면에 출력해 주는 파이썬 스크립트 karrot_bot.py를 작성해줘."

이 프롬프트가 전송되면 에이전트가 필요한 라이브러리 설정부터 실행 가능한 파일 생성까지 수행합니다. 생성된 프로그램은 대상 웹 페이지의 HTML 레이아웃을 파악한 뒤 나눔 상품 카드의 텍스트 정보를 추출하는 방식으로 설계됩니다. 터미널에서 python karrot_bot.py를 입력하면 화면에 동네 나눔 글 정보가 정돈되어 출력되는 것을 확인할 수 있습니다.

관심 키워드 필터링과 중복 알림 방지 로직 장착하기

모든 나눔 게시글을 실시간으로 확인하면 불필요한 정보까지 과도하게 유입됩니다. 원하는 물품만 선별하여 수집할 수 있도록 필터링 로직과 중복 알림을 걸러내는 장치를 덧붙입니다. Claude Code에게 "입력받은 키워드 목록에 해당하는 단어가 제목에 포함될 때만 알림을 보내고, 이미 한 번 확인한 글 ID는 txt 파일에 저장해 중복 조회를 막는 기능을 추가해줘"라는 구체적인 추가 지시사항을 전달합니다.

개발 보조 에이전트는 기존 작성 파일의 맥락을 스스로 이해하여 특정 지점의 로직을 안전하게 수정해 줍니다. 수정이 완료되면 프로그램은 주기적으로 작동할 때마다 사용자가 설정해 둔 단어 목록과 비교 작업을 수행하며, 한 번 식별한 게시글 식별자는 로컬 텍스트 파일에 기록하여 중복 전송을 차단합니다.

텔레그램 메시지 발송과 10분 주기 자동 실행 세팅

이제 정제된 정보를 실시간 모바일 알림으로 전송하고 프로세스를 주기적으로 가동할 차례입니다. 메신저의 전용 계정 생성 채널(BotFather)을 이용해 약 3분 만에 토큰과 채팅 ID를 발급받아 준비합니다. 준비가 끝나면 "추출된 나눔 정보를 지정된 텔레그램 채팅방으로 전송하는 텔레그램 API 코드를 연동해 주고, 10분 주기로 이 스크립트가 반복 실행되도록 대기 시간을 추가해줘"라고 기술적 요구사항을 요청합니다.

에이전트는 메신저 제어용 무거운 종속성 패키지 대신, 가벼운 HTTP 요청 모듈을 도입해 전송을 처리하도록 구현합니다. 터미널 창에서 해당 스크립트를 상시 실행해 두면, 설정된 10분 주기로 게시판을 순회하며 원하는 물품이 발견되는 즉시 등록된 채팅방으로 알림을 보냅니다.

너무 잦은 조회가 부르는 차단 위험과 보안 경고

자동화 알림을 세팅해 두면 매우 유용하지만, 지나치게 빠른 주기로 데이터를 가져오는 행위는 주의해야 합니다. 트래픽 비용을 고려하지 않고 조회 주기를 10초 혹은 20초 단위로 아주 짧게 잡으면 해당 중고 플랫폼의 보안 방화벽에 의해 접속이 제한될 우려가 있습니다. 과도한 요청은 일시적으로 IP 차단을 유발하므로 대기 시간을 10분 단위 이상으로 비교적 여유롭게 설정해 두는 것이 권장됩니다.

국내 메신저의 알림 비즈니스 채널 API는 엄격한 기업 인증 절차가 요구되므로 개인 용도의 개발 환경에서는 메신저 채널을 개설하여 관리하는 형태 외에는 연동에 제약이 많습니다. 아울러 컴퓨터를 매일 24시간 켜 두는 부담을 피하려면 가상 사설 서버나 클라우드 환경의 컨테이너를 빌려 백그라운드로 실행하는 방안도 검토해 볼 만합니다.

지금 바로 동네 나눔 키워드 하나를 등록해 보세요

시작부터 너무 많은 타깃 단어들을 지정하면 예외 처리가 까다로워지고 유지 보수가 복잡해질 수 있습니다. 평소에 구하고 싶었던 단 하나의 물품 키워드로 시작하여 정상 작동 여부를 관찰하는 방식을 추천합니다.

개발 자동화 도구를 직접 연동하여 예상대로 결과가 순환하는 흐름을 확인하는 것은 훌륭한 학습 경험이 됩니다. 메시지 수신 채널과 작성한 스크립트를 잘 조합하여 원하던 알림을 받아 보시기 바랍니다. 이러한 기초 설계 경험은 향후 여러 채널의 유용한 소식들을 취합하는 대규모 수집 시스템으로 확장하기 위한 훌륭한 밑거름이 될 것입니다. 지금 터미널 창을 열어 첫걸음을 시도해 보십시오.