상세 정보
🇰🇷 KR Market Analysis Tool (Antigravity)
AI 기반 한국 주식 시장 데이터 분석 및 종가 패턴 탐색 시스템 사용자 로컬 환경 설치형 앱 | Python 백엔드 + Next.js 프론트엔드
⚠️ 구매 전 필독 및 이용 약관 (필수 확인)
1. 가격 정책 (Price Policy)
잔여 수량 판매 완료 후 가격은 단계적으로 상승합니다.
본 프로그램은 얼리버드/한정 수량 정책에 따라 운영되므로, 현재 안내된 가격이 가장 저렴한 시점입니다.
2. 프로그램 사용 목적 및 범위 (이용약관)
본 프로그램은 개인 투자자가 데이터 분석 및 바이브 코딩(Vibe Coding)을 활용하여 주식 시장을 학습하고, 개인적인 투자 판단에 참고하기 위한 순수 교육 및 보조 목적으로 제공됩니다.
구매자 본인의 개인 기기에서 개인 투자 목적으로만 사용해야 합니다.
[엄격 금지 사항] * 본 프로그램의 전부 또는 일부를 제3자에게 재판매, 양도, 대여, 공유하는 행위
생성된 데이터 및 분석 결과를 유료 리딩방, 종목 추천방, 투자자문 서비스 등에 활용하는 행위
「자본시장과 금융투자업에 관한 법률」상 무등록 투자자문업 또는 불법 유사투자자문업을 영위하는 행위
본 프로그램의 결과물을 활용하여 상업적 수익을 창출하는 모든 행위
위반 시 사전 통보 없이 프로그램 사용권이 박탈될 수 있으며, 민·형사상 법적 조치가 취해질 수 있습니다.
3. 투자 책임 고지 (면책 조항)
KR Market Analysis Tool이 제공하는 차트 분석, 종가 패턴 스크리닝, AI 분석 결과는 특정 금융상품의 매수·매도를 권유하는 것이 아닙니다.
과거의 수익률 백테스트 결과가 미래의 수익을 보장하지 않으며, 주식 투자는 원금 손실 위험이 따릅니다.
투자에 대한 최종 결정과 그에 따른 모든 손익의 책임은 전적으로 투자자 본인에게 있으며, 개발자 및 판매자는 직·간접적 손해에 대해 어떠한 법적 책임도 지지 않습니다.
🎯 프로그램 개요 및 핵심 기능
KR Market Analysis Tool은 KOSPI/KOSDAQ 시장의 실시간 데이터, 기관/외국인 수급, 기술적 지표를 결합하여 투자자의 종가 데이터 분석을 돕는 올인원 로컬 플랫폼입니다.
기능설명VCP 스크리너Mark Minervini의 변동성 수축 패턴(VCP) 조건에 근접한 종목 발굴종가 패턴 분석뉴스, 차트, 수급 데이터를 종합하여 종가 매수 관점의 분석 지표 제공AI 데이터 요약Gemini AI 모델을 활용한 개별 종목 관련 뉴스 요약 및 지표 해석Market GateRSI, MACD, 섹터 상대강도(RS)를 통한 시장 전체 리스크 평가실시간 대시보드Next.js 기반의 직관적인 모던 웹 인터페이스 제공
Sheets로 내보내기
💻 시스템 요구사항 및 사전 준비
필수 환경
OS: macOS / Windows / Linux
Python: 3.10 이상
Node.js: 18 이상 (npm 9 이상)
API Key: Google Gemini API Key (AI 분석 기능 구동용 필수)
참고: Google Cloud (console.cloud.google.com) 신규 계정 가입 시 제공되는 $300 무료 크레딧을 활용하여 상위 모델(Gemini 1.5 Pro 등)을 일정 기간 무료로 테스트할 수 있습니다.
선택 사항: OpenAI GPT 모델 사용 시
OPENAI_API_KEY필요
📦 설치 및 실행 가이드
1단계: 프로젝트 다운로드 및 환경 설정
배포받은 kr_market_package 폴더를 원하는 위치(예: ~/Documents)에 배치한 후, 프로젝트 루트 디렉토리에 .env 파일을 생성하고 API 키를 입력합니다.
코드 스니펫
# 필수
GEMINI_API_KEY=your_gemini_api_key_here
# 선택
OPENAI_API_KEY=your_openai_key_here
2단계: 의존성 패키지 설치
터미널을 열고 백엔드 및 프론트엔드 구동에 필요한 패키지를 설치합니다.
Bash
# 백엔드 (Python)
cd kr_market_package
pip install -r requirements.txt
# 프론트엔드 (Node.js)
cd frontend
npm install
3단계: 프로그램 실행 (수동 실행 방식)
시스템은 백엔드 서버와 프론트엔드 웹 서버가 동시에 실행되어야 정상 작동합니다. 터미널 창을 2개 열어 각각 실행하십시오.
터미널 1 (백엔드 서버):
Bash
cd kr_market_package python flask_app.py # Mac의 경우 python3 flask_app.py # 정상 실행 시 http://127.0.0.1:5001 에서 대기 (필수 확인)터미널 2 (프론트엔드 서버):
Bash
cd kr_market_package/frontend npm run dev # 정상 실행 시 브라우저에서 http://localhost:3000 으로 자동 접속 가능
📊 대시보드 사용 및 데이터 업데이트
주요 페이지 경로
페이지명URL설명메인 대시보드/dashboard/kr시장 현황, 섹터 성과, 종합 지표 요약종가 분석 상세/dashboard/kr/closing-bet조건 부합 종목 리스트 및 상세 지표VCP 스크린/dashboard/kr/vcpVCP 패턴 필터링 결과
Sheets로 내보내기
데이터 수동 업데이트 (장 마감 후 일 1회 권장)
웹 대시보드의 업데이트 버튼이 응답하지 않을 경우, 터미널에서 스크립트를 직접 실행하여 진행 상황을 확인하는 것을 권장합니다.
Bash
# 전체 데이터 갱신
python update_all_ordered.py # Mac: python3 update_all_ordered.py
# 개별 모듈 업데이트
python scheduler.py --daily # 일별 가격 데이터 수집
python scheduler.py --inst # 기관/외국인 수급 데이터 수집
python scheduler.py --jongga-v2 # 종가 분석 지표 연산
python scheduler.py --ai # AI 분석 처리
⚙️ 상세 설정 옵션 (커스텀)
분석 종목 수 변경 (
engine/generator.py):top_n = 15값을 변경하여 분석할 최대 종목 수를 조정할 수 있습니다. 수치를 높이면 처리 시간이 비례하여 증가합니다.AI 모델 변경 (
engine/llm_analyzer.py):model_name = "gemini-3-pro-preview"값을 수정하여 사용할 모델을 지정합니다. 최신 모델을 사용할수록 분석 품질이 향상됩니다.포트(Port) 충돌 시 변경:
flask_app.py22번 줄의port=5001값을 비어있는 다른 포트 번호로 변경할 수 있습니다. 프론트엔드는 기본3000포트가 사용 중일 경우 자동으로 사용 가능한 다른 포트를 할당합니다.
🛠️ 문제 해결 (Troubleshooting)
일반 오류
오류 증상원인 및 해결 방법ModuleNotFoundErrorpip install -r requirements.txt 명령어를 다시 실행하여 누락된 패키지 설치GEMINI_API_KEY not found프로젝트 루트 경로에 .env 파일이 존재하는지, 키 값이 정확히 입력되었는지 확인Port 5001 in use백그라운드에서 실행 중인 Flask 강제 종료 (`lsof -ti:5001ENOENT: no such file프론트엔드 캐시 오류. frontend 폴더 내에서 rm -rf .next 실행 후 npm run dev 재시작
Sheets로 내보내기
Windows 사용자 전용 오류 해결
1. 인코딩 오류 (UnicodeDecodeError)
원인: 한글 Windows 환경(cp949 기본)에서 UTF-8로 저장된 파이썬 스크립트를 읽을 때 발생하는 문자가 깨지는 현상입니다.
해결 방법:
update_all_ordered.py파일 내exec(open(...))구문에encoding='utf-8'옵션을 추가합니다.Python
# 수정 전 exec(open('경로/create_complete_daily_prices.py').read()) # 수정 후 exec(open('경로/create_complete_daily_prices.py', encoding='utf-8').read())
2. 경로 인식 오류 (SyntaxWarning: invalid escape sequence)
원인: Windows의 디렉토리 경로 구분자인 역슬래시(
\)를 파이썬이 이스케이프 문자로 오인하여 발생합니다.해결 방법: 파일 경로를 지정하는 문자열 앞에
r을 붙이거나, 역슬래시를 두 번(\\) 입력합니다.Python
# 수정 전 "D:\MyProjects\kr_market_package" # 수정 후 r"D:\MyProjects\kr_market_package" # 또는 "D:\\MyProjects\\kr_market_package"
업데이트 로그 (최신 버전 확인)
v2.0- Next.js 15 적용, Turbopack 비활성화v1.9- 최신 Gemini 모델 지원 추가v1.8- 분석 점수 체계 개편 (12점 만점 기준)v1.7- 시장 게이트 기능 강화 (RSI, MACD, 섹터 RS 추가)
추가 지원이 필요하거나 버그 리포트가 있는 경우 개발자에게 직접 문의하시기 바랍니다.
