Claude Code 활용 미국 주식 Fear Greed 텔레그램 봇 만들기
기상도처럼 받아보는 미국 주식 투자 지표
미국 주식을 거래할 때 시장의 과열 여부를 판단하는 지표로 CNN의 공포 탐욕 지수(Fear and Greed Index)가 자주 활용됩니다. 이 지수가 20 미만으로 떨어져 극단적 공포 상태에 도달하면 시장의 저점을 탐색하는 기회가 될 수 있습니다. 반대로 80을 초과해 극단적 탐욕 구간에 진입하면 자산 비중을 조절하는 타이밍으로 해석하기도 합니다. 투자자들은 이러한 지표를 바탕으로 시장의 감정적 변화를 감지하고 이성적인 투자 판단을 내리는 데 도움을 받습니다.
매번 관련 웹사이트에 접속하여 이를 확인하는 번거로움을 줄이기 위해 모바일 기기로 즉각적인 알림을 송신하는 전용 시스템을 구축할 수 있습니다. 미국 주식 공포 탐욕 지수를 매일 아침 특정 시간에 자동으로 조회하고 설정한 기준에 부합할 때 텔레그램 메시지를 발송하는 자동화 파이프라인을 구성하는 방법이 존재합니다. 완성된 시스템은 시장의 급격한 변동성을 포착하고 대응 속도를 높이는 데 유용하게 활용될 것입니다.
시스템 구축을 위한 준비 사항
이번 개발에 주축이 되는 도구는 Anthropic의 터미널 기반 AI 어시스턴트인 Claude Code 입니다. 해당 도구를 사용하면 명령줄 인터페이스 내에서 코드 생성부터 디버깅까지 막힘없이 진행할 수 있습니다. Node.js 실행 환경이 사전에 컴퓨터에 마련되어 있어야 하며, 패키지 매니저를 통해 전역 환경에 설치되어 작동할 수 있어야 합니다.
만약 터미널 환경에 Claude Code 가 전역 설치되어 있지 않다면, 공식 문서의 가이드를 참조하여 패키지를 추가할 수 있습니다. 추가적으로 알림 메시지를 수신할 수 있도록 텔레그램 메신저 앱 내에서 봇을 신규로 생성해두어야 합니다. 텔레그램 공식 봇 관리 계정인 봇파더를 통해 생성한 API 접근 토큰과 메시지를 전송받을 채널 혹은 그룹의 고유 식별자 ID를 미리 기록해 둡니다. 이 준비물들이 모두 구비되면 다음 단계로 넘어가 로직을 구성합니다.
4가지 단계로 완성하는 알림 시스템
가장 먼저 작업을 시작할 디렉터리를 터미널에서 신규로 개설합니다. 프로젝트 폴더 내에서 Claude Code 를 구동하여 초기 설정을 위임하는 것으로 작업을 시작합니다. 대화창을 통해 신규 프로젝트 파일 생성을 지시하면 해당 도구가 환경 구성에 필요한 패키지 구조를 제안해 줍니다.
지시를 입력한 후 터미널에 제안되는 패키지 설치 항목을 검토하고 동의를 진행하면 필요한 파일이 자동으로 구성됩니다. 웹 통신을 위해 사용되는 라이브러리가 기본적으로 연동되며 개발을 수행하기 위한 기초적인 템플릿 코드가 자리를 잡게 됩니다.
초기 구성이 완료되면 데이터 소스로부터 시장 지수를 획득하는 통신 모듈을 설계해야 합니다. CNN 웹페이지의 복잡한 마크업을 매번 파싱하는 대신, 유지보수가 용이하고 부하가 적은 데이터 접근 경로를 모색하는 프롬프트를 작성하여 입력합니다.
어시스턴트의 탐색 과정을 거쳐 분석된 최적의 경로를 기반으로 지수와 상태 데이터를 반환하는 함수가 완성됩니다. 이 단계에서 수집된 정보가 정상적인 형태를 갖추고 있는지 테스트 실행을 유도하여 반환되는 결괏값의 필드 구성을 확인할 수 있습니다.
지수를 매번 전송하여 스팸성 알림이 되는 것을 차단하기 위해 특정 임계치를 설정하고 조건에 맞을 때에만 메시지를 전송하는 차별화된 로직을 파일에 덧붙입니다. 시장 지표가 극단적인 수준에 도달했을 때 유의미한 정보가 되도록 발송 기준을 수립합니다.
이 코드는 이전 발송 상태를 기록한 임시 파일을 로컬 디렉터리에 보관하고 새로운 데이터가 유입될 때마다 이를 참조해 변경 사항이 감지되었거나 경고 수준일 때에만 요청을 보냅니다. 이를 통해 불필요한 API 요청 횟수를 억제하고 데이터 전송 효율을 향상시킬 수 있습니다.
매번 사용자가 명령어를 입력하지 않아도 특정 시점마다 자동으로 해당 프로그램이 구동되어 최신 시장 정보를 수집하는 스케줄링 설정을 병행합니다. 컴퓨터의 백그라운드 환경에서 지속적으로 프로세스가 구동될 수 있도록 설정을 작성합니다.
지시에 따라 생성된 설정 파일을 실행해 두면 백그라운드에서 백업 스크립트가 대기하며 지정된 시간대마다 연동 동작을 반복 수행합니다. 이를 통해 완전히 자율적으로 시장 정보를 체크하여 텔레그램 채널로 결과를 공유하는 파이프라인이 정착됩니다.
예기치 못한 오류가 발생할 때 대처법
- 문제 상황: 텔레그램 메시지 발송 실패와 함께 400 에러 코드가 나타납니다.
원인: API 통신 과정에서 전달한 토큰 값의 규격이 맞지 않거나 알림을 받을 대상 채널의 ID 식별자에 누락이 있을 가능성이 큽니다. 특히 텔레그램 비공개 채널의 경우 고유 접두사를 포함한 전체 숫자 식별자를 올바르게 기입해야만 전송을 허용합니다.
대처법: 환경 변수에 등록한 값에 공백이나 오타가 없는지 재차 점검하고 기본적인 API 주소 형식을 확인해야 합니다. - 문제 상황: 수집 결과 값에서 정의되지 않은 변수 오류가 출력됩니다.
원인: 웹 사이트 측에서 데이터 제공 주소의 구조를 전면 개편했거나 요청 패킷을 차단하기 위해 추가적인 헤더 검증 단계를 도입했을 때 발생할 수 있습니다.
대처법: 요청 헤더에 실제 브라우저와 유사한 환경 정보를 지정하거나 신뢰성 높은 대체 데이터 소스를 물색해 주소를 교체하는 것이 타당합니다. - 문제 상황: 로컬 캐싱용 JSON 파일 읽기 및 쓰기 작업이 실패합니다.
원인: 백그라운드 데몬으로 구동될 때 스크립트의 실행 경로와 타깃 파일의 참조 경로가 일치하지 않아 시스템 권한 위반이나 경로 부재 현상이 발생할 수 있습니다.
대처법: 상대 경로 대신 Node.js 내장 모듈을 이용하여 절대 경로로 대상 파일 위치를 명확히 지정해 주면 해결이 가능합니다.
향후 확장 방안
기본적인 알림 파이프라인의 완성도를 높인 후에는 단순 수치 모니터링을 넘어 다각적인 시장 데이터를 종합하는 방향으로의 고도화가 가능합니다. 예컨대 환율 변동 정보나 주요 주가지수의 동향을 통합하여 연동하면 매수 및 매도 타이밍에 관한 종합적인 리포트를 발행할 수 있습니다. 이러한 데이터 파이프라인을 하나씩 늘려나가며 나만의 맞춤형 투자 어시스턴트를 점진적으로 완성해 나가는 것도 좋은 방법입니다.
이런 글도 있어요
관련 검색어
- 🔍 Claude Code 사용법
- 🔍 Claude Code 비교
- 🔍 공포 탐욕 지수 사용법
- 🔍 공포 탐욕 지수 비교
- 🔍 텔레그램 봇 사용법
- 🔍 텔레그램 봇 비교
