Claude Code 활용한 LH 청약 공고 알림봇 만들기 (텔레그램 연동)

2026-06-10

매번 사이트에 방문하기 번거롭다면

준비해야 할 두 가지 도구

시스템을 만들기 위해 사전 단계로 준비할 항목은 매우 간단합니다. 먼저 수집된 공고 정보를 메시지 형태로 전달받을 텔레그램 봇 정보가 필요합니다. 메신저 내에서 전용 봇을 생성한 다음, API 요청에 활용할 고유 토큰과 메시지를 전송받을 채팅방의 고유 ID 값을 미리 적어두면 편리합니다.

그다음 준비할 도구는 로컬 PC 터미널에서 코딩 작업을 수행해 줄 Claude Code 환경입니다. 사용자의 개발 디렉터리를 분석하여 필요한 코드를 작성하고 오류를 잡아내는 과정을 도와줍니다. 이 환경을 갖추면 터미널 내부에서 복잡한 명령어를 복사하고 붙여넣는 일 없이도 효율적으로 프로젝트를 관리할 수 있게 됩니다. 이 방식을 통해 나만의 LH 청약 알림봇을 완성하기 위한 기반이 다져집니다.

Step 1. 로컬 환경에 작업 폴더 생성하기

프로젝트 시작을 위해 컴퓨터에서 명령 프롬프트나 터미널을 실행합니다. 알림봇 파일들을 모아두고 관리할 전용 디렉터리를 만들고 해당 경로로 이동합니다. 폴더의 명칭은 식별하기 편리하도록 영문 소문자로 지정해 주는 것이 관리 측면에서 권장되는 편입니다.

폴더 생성이 완료되고 정상적으로 해당 경로로 진입했다면, 준비된 에이전트 프로그램을 구동하기 위해 아래 명령어를 차례로 입력합니다. 터미널 명령을 수행하면 Claude Code 에이전트 프로그램이 활성화되며 대화형 코딩을 진행할 준비가 끝납니다.

# 폴더 생성 후 경로 진입
mkdir lh-bot
cd lh-bot

# 에이전트 구동
claude

Step 2. 구현할 사양을 담아 자연어로 지시하기

에이전트가 실행되면 만들고자 하는 소프트웨어의 구체적인 작동 방식과 요구 조건을 자연어로 명확하게 설명해 주어야 합니다. 개발 목적과 포함되어야 할 수집 대상, 데이터 저장 방식 등을 구체적으로 세분화하여 적을수록 만들어지는 결과물의 정확도가 향상됩니다.

중복된 소식이 매번 발송되는 현상을 막기 위해 발송 이력을 기록할 저장 파일 정보도 조건에 포함해 줍니다. 아래 예문과 같이 필요한 상세 기능을 하나씩 명시하여 프롬프트로 작성해 봇에게 전달하면 됩니다.

LH 청약플러스(https://apply.lh.or.kr) 웹사이트에서 서울/경기 지역의 최신 임대주택 공고를 수집해서 내 텔레그램 채널로 발송하는 Node.js 스크립트를 만들어줘.

요구 조건:
1. axios와 cheerio 패키지를 써서 공고 목록을 크롤링해줘.
2. 중복 알림을 막기 위해 이미 보낸 공고 ID는 로컬 파일(sent_announcements.json)에 저장해줘.
3. 텔레그램 봇 토큰과 Chat ID는 스크립트 상단의 변수로 쉽게 설정할 수 있게 빼줘.
4. 다 만들고 나서 필요한 패키지 설치와 실행 테스트까지 네가 직접 /run으로 진행해줘.

Step 3. 자율 설계 진행 흐름 살피기

전송된 지시 사항을 분석하여 시스템 구조를 스스로 검토합니다. 공고 페이지에서 요소를 추출할 웹 스크레이퍼 모듈과 알림 메시지를 보낼 라이브러리를 고려하여 작업 디렉터리에 파일을 채워 넣기 시작합니다. 코드를 구성하고 필요한 라이브러리를 세팅하는 과정이 순차적으로 이루어집니다.

설계와 코딩 과정에서 사용자의 확인이 필요한 승인 항목이 화면에 표시되면 승인 키를 눌러 다음 단계로 진행합니다. 복잡한 초기 라이브러리 빌드와 초기 기획 작업을 일련의 조력 아래에서 순조롭게 마칠 수 있으므로 전반적인 노력이 대폭 단축됩니다.

Step 4. 접속 토큰 기입 및 연동 테스트

초기 소스코드가 갖추어졌다면 이제 봇 작동에 필요한 고유 정보를 소스 파일에 대입할 타이밍입니다. 파일의 최상단이나 환경 변수 설정 영역을 찾아 준비해 둔 텔레그램 봇 토큰과 채팅 ID 값을 정확히 기입하고 저장합니다. 해당 정보가 등록되어야만 원하는 대상 채널로 알림이 정상 전달됩니다.

저장을 마치고 정상 구동 여부를 확인하기 위해 아래 테스트 명령어를 실행합니다. 이 과정을 통해 작성된 스크립트가 수집 대상 웹페이지에 원활히 접근하고 실제 메시지를 수신 장치로 잘 내보내는지 텔레그램 봇 연동 상태를 최종적으로 확인합니다.

/run node index.js

요청이 올바르게 처리되었다면 연결된 메신저 방에 첫 번째 알림 메시지가 도착하는 모습을 확인하게 됩니다. 아울러 중복 알림을 걸러내기 위해 설정했던 전송 기록 파일도 디렉터리 내에 알맞게 자동 생성됩니다.

Step 5. 특정 시간마다 동작하도록 설정하기

원하는 메시지가 전달되는 모습을 확인했다면 이제 정해진 일정에 따라 자동으로 작업이 호출되도록 세팅할 단계입니다. OS에서 제공하는 예약 작업을 활용해 매일 아침 특정 시간대에 이 실행 파일이 주기적으로 실행되도록 등록해 줍니다.

이 과정을 마치면 수동으로 코드를 실행하지 않아도 약속된 주기마다 컴퓨터가 공고를 대조하여 메시지를 보내는 LH 청약 알림봇의 핵심 뼈대가 완성됩니다. 세부 조건의 수정이 필요한 경우 추가 필터를 코드에 기록하는 방식으로 성능을 보강할 수 있습니다.

생산성을 높이는 생활 밀착형 아이디어

반복되는 생활 속 사소한 번거로움을 기술적으로 개선하는 자동화 시도는 일상의 효율을 한 단계 높이는 유용한 경험이 됩니다. 바쁜 하루 중에서 놓치기 쉬운 주요 분양 공고나 알림 소식을 메신저로 실시간 수신하여 편리한 정보 관리가 가능해집니다.

직접 모든 프로그래밍 언어를 깊게 이해하지 못하더라도 똑똑한 AI 개발 보조 도구의 협업을 통해 실생활에 쓰이는 도구를 만드는 기쁨을 맛볼 수 있습니다. 완성된 로직은 LH 공고 확인뿐 아니라 다른 정보 알림 서비스로 얼마든지 확장하여 재구성하는 것도 가능합니다. 다른 영역에서도 이러한 업무 자동화 전략을 응용한다면 유용하게 대처할 수 있습니다.

단순하고 불필요한 행위에 시간을 낭비하는 대신 자신만의 스마트한 비서를 만들어 일상에 활력을 더해 보시기 바랍니다. 이번 시스템 구축 과정을 차근차근 따라 해보며 일상에 필요한 알림 도구를 완성해 보시기 바랍니다. 손쉽게 업무 자동화의 가치를 체험할 수 있는 좋은 기회입니다.