Claude Code로 CoinMarketCap 신규 상장 알림봇 1시간 만에 완성하기
CoinMarketCap 신규 코인 상장 소식을 실시간으로 받아보기
코인 시장에서는 남들보다 1초라도 빨리 정보를 얻는 게 실제로 중요할 때가 있습니다. 특히 새로 상장되는 코인은 초기에 급등락이 심해서 실시간 감시가 필요하구요. 매번 거래소 창을 띄워 두고 새로고침만 할 수는 없으니, Claude Code로 자동 봇을 만들어 두면 꽤 든든합니다. 이번에는 CoinMarketCap API를 활용해 신규 상장 코인을 포착하고, 내 텔레그램으로 알림을 즉시 보내는 봇을 만들어 보겠습니다. 어려운 코딩 지식은 많이 필요하지 않구요, Claude Code에게 말로만 지시해 완성하는 흐름을 보여드릴게요.
준비물은 텔레그램과 무료 API 키 하나씩
이번 프로젝트는 Claude Code 하나면 바로 시작할 수 있습니다. 데이터를 가져올 CoinMarketCap의 무료 API 키가 필요하구요, 알림을 받을 텔레그램 봇 토큰과 Chat ID만 미리 준비하면 충분합니다. 5분만 투자해도 첫 결과물이 보이니까 바로 실행해 보시죠.
단계별로 봇 완성해 가기
먼저 프로젝트를 진행할 폴더를 하나 만들고 터미널에서 Claude Code를 실행합니다. 첫 단계에서는 기능을 한꺼번에 붙이기보다 신규 상장 코인 목록이 정상적으로 조회되는지만 확인할 겁니다. 뼈대부터 잡는 게 핵심이거든요.
이 프롬프트는 복잡한 기능 없이 딱 API 응답만 터미널에 띄우도록 지시한 것입니다. 이렇게 뼈대만 먼저 만들어 두면 나중에 에러가 나도 원인 파악이 훨씬 쉽거든요. 잠시 기다리면 Claude Code가 필요한 라이브러리를 알아서 설치하고 기본 코드를 작성해 줍니다.
터미널에 코인 이름이 잘 찍히는 걸 확인했다면, 이제 이 정보를 내 텔레그램 방으로 보내는 기능을 추가할 차례입니다. 텔레그램 봇 API는 구조가 단순해서 한 줄만 추가해도 바로 알림을 보낼 수 있거든요.
기존에 완성된 뼈대 코드에 텔레그램 전송 함수만 자연스럽게 녹아들도록 Claude Code가 편집을 처리하구요. 코드가 수정된 뒤 실행해 보면 내 스마트폰 텔레그램으로 첫 알림 메시지가 도착하는 것을 직접 보게 됩니다.
지금 상태로는 스크립트를 실행할 때마다 이미 보낸 코인을 계속 중복해서 보내게 됩니다. 알림방이 도배되는 걸 막으려면 이미 확인한 코인의 ID를 어딘가에 저장해 두고 필터링해야 하거든요.
이 단계가 들어가야 비로소 실전에서 쓸 수 있는 깔끔한 알림봇이 완성되구요. 로컬 파일 기반의 간단한 캐싱이지만, 서버나 내 PC에서 장시간 돌릴 때 리소스를 아끼고 스팸을 막아주는 데 꽤 쏠쏠한 역할을 합니다.
마지막으로 매번 수동으로 실행하지 않고 10분마다 자동으로 감시하도록 반복 기능을 붙여줄 겁니다. 이 부분까지 들어가면 사실상 손이 덜 가는 자동화 도구가 됩니다.
예외 처리까지 들어간 무한 루프 코드가 완성되었구요. 이제 터미널에 켜 두기만 하면 10분마다 알아서 감시하고 새 코인이 나올 때마다 내 폰으로 알림을 보내는 완전 무인 시스템이 작동하기 시작합니다.
여기서 막히면 이것부터 확인해 보세요
-
현상: API 호출 결과로 401 Unauthorized 에러 코드가 터미널에 반환되며 코인 데이터를 불러오지 못하는 상태입니다.
원인: CoinMarketCap의 헤더 키 명칭인 `X-CMC_PRO_API_KEY`가 잘못 입력되었거나 발급받은 API 키가 활성화되는 데 수 분 정도 걸리기 때문입니다.
해결: API 대시보드에 로그인해서 키가 활성(Active) 상태인지 직접 대조해 보시구요. 코드 내에서 헤더의 대소문자가 공식 문서 규격과 일치하게 들어갔는지 한 줄씩 확인한 다음 다시 실행해 줍니다. -
현상: 코드는 에러 없이 잘 돌았는데 텔레그램으로 알림 메시지가 하나도 오지 않습니다.
원인: 봇 토큰과 Chat ID가 뒤바뀌어 입력되었거나, 생성한 봇 채널에 첫 인사인 `/start` 메시지를 보내지 않아서 세션 연결이 누락되었기 때문입니다.
해결: 텔레그램 검색창에 생성한 봇 아이디를 입력해 들어가서 대화 시작 버튼을 먼저 눌러주고요. 웹 브라우저 주소창에 `https://api.telegram.org/bot<내봇토큰>/getUpdates`를 입력하여 나타나는 JSON 결과의 ID 값을 Chat ID 변수에 덮어씌워 줍니다. -
현상: 스크립트가 실행될 때 sent_coins.json 파일 부분에서 JSONDecodeError 예외가 발생하며 강제 종료됩니다.
원인: 프로그램이 처음 생성할 때 빈 파일에 아무 내용도 적지 않아서 파이썬의 json 라이브러리가 데이터를 해석하지 못해 일어나는 현상입니다.
해결: 에러가 발생한 sent_coins.json 파일을 탐색기나 터미널에서 과감하게 삭제해 주시구요. 파일이 없는 상태에서 프로그램을 다시 가동하면 봇이 스스로 예외를 인지하고 올바른 초기 구조를 지닌 json 파일을 새로 생성해 줍니다.
다음에는 이런 기능도 붙여볼 수 있습니다
이번에는 단순 상장 정보만 받아봤지만, 여기에 DexScreener나 실시간 가격 조회 API를 결합해서 상장 직후의 거래량 변화까지 텔레그램 알림에 같이 실어 보낼 수도 있습니다. 다음 편에서는 이렇게 수집한 코인들의 거래소별 가격 차이를 계산하는 실시간 김프 및 역프 감지 파이프라인으로 한 단계 더 확장해 볼 수 있습니다.
이런 글도 있어요
관련 검색어
- 🔍 Claude Code 사용법
- 🔍 Claude Code 비교
- 🔍 CoinMarketCap 사용법
- 🔍 CoinMarketCap 비교
- 🔍 코인 알림봇 사용법
- 🔍 코인 알림봇 비교