프로젝트 소개

AI Finance는 GitHub Actions를 기반으로 24/7 자동 운영되는 시장 분석 및 모니터링 시스템이다. README는 명확히 시뮬레이션·분석 전용이며 자동 매매를 금지하고, 실제 투자 결정은 사용자 판단이 필요하다고 밝힌다. 결과물은 GitHub Pages 대시보드와 Telegram 실시간 알림으로 전달된다. 핵심 기능은 여러 영역으로 나뉜다. 시장 분석은 4시간마다 7개 섹터 22개 이상 종목을 HMM 레짐, 센티멘트, 포트폴리오 관점에서 분석한다. 긴급 뉴스는 1시간마다 7개 RSS 피드와 6개 카테고리 키워드를 모니터링한다. 해외 시장은 KOSPI 휴장 시간에 매시간 13개 글로벌 지수·선물을 추적한다. 일본 위기 모니터는 엔화 캐리 청산 압력과 BOJ 금리 인상을 매일 09:30, 22:00에 추적한다. 비트코인 본위제 모니터는 ETF 자금 흐름, 채굴, ARMA 법안을 매일 09:00, 22:00에 다룬다. 가치 분석 계열도 포함된다. 저평가 스크리너는 KOSPI 47개 종목의 가치 점수와 WATCHLIST를 매일 06:00에 산출하며 코스피 평균 대비 상대 평가를 사용한다. 가치 훼손 모니터는 주가가 아닌 펀더멘털(EPS·BPS·수익성) 훼손을 감시한다. DCF 적정가는 15개 대형주의 현금흐름을 평가하고, 분기 실적 리뷰는 DART API 기반 어닝 분석을 수행한다. AutoResearch는 가치 가중치 진화와 Forward Test 평가를 매일·매월 진행한다. 설치와 실행은 저장소 클론, requirements.txt 설치, Telegram Bot 토큰·Chat ID와 DART API 키 설정, 로컬 테스트 스크립트 실행, GitHub push를 통한 워크플로 자동 실행 순서로 안내된다. 프로젝트 구조는 core 유틸리티(환경변수 로더, 텔레그램, yfinance 래퍼, 상태 저장), docs(GitHub Pages 출력), config(섹터 정의), .github/workflows(11개 워크플로), tests, 각종 모니터·분석 스크립트로 구성된다. 자동화는 11개 워크플로로 운영된다. Daily Finance Analysis(4시간), Breaking News Monitor(1시간), Overseas Market Monitor(KOSPI 휴장 매시간), Japan Crisis Monitor, Bitcoin Standard Monitor, Value Screener(매일 06:00), Auto-Research Value(07:00), Auto-Research Portfolio(03:00), DCF Valuator(07:30), Earnings Reviewer(09:00), Forward Test Eval(매월 1일 08:00)이 있다. 보안 측면에서는 API 키를 GitHub Secrets에 저장하고 config/.env 커밋을 금지하며, defusedxml로 XXE 공격을 방어하고, 외부 호출은 HTTPS를 사용하며, 워크플로 동시성 제어로 race condition을 방지하고 subprocess 호출 시 list args를 사용한다고 설명한다. 위협 모델 문서와 회귀 테스트도 제공된다. 라이선스·면책 조항은 개인 학습 및 분석 용도임을 강조한다.