chjm-ai/stock-monitor

stock-monitor은(는) 무엇을 하나요?

전방위 지능형 주식 모니터링 및 조기 경보 시스템입니다. 원가 대비 수익률(%), 이동평균선 골든크로스/데드크로스, RSI 과매수/과매도, 거래량 이상 변동, 갭 상승/하락, 동적 이익 실현 등 7가지 주요 경보 규칙을 지원합니다. 중국 투자자 관행에 맞춰 제작되었습니다 (빨간색 상승, 초록색 하락).

기능

• 실시간 모니터링: 설정된 시간 간격으로 주식 가격 및 지표를 자동 조회
• 7가지 경보 규칙: 원가 대비 수익률, 이동평균선, RSI, 거래량, 갭, 동적 이익 실현
• 사용자 정의: 각 규칙에 대한 임계값 및 활성화 여부를 개별 설정 가능
• 백테스팅: 과거 데이터를 기반으로 전략 성과 검증
• 알림: 조건 충족 시 사용자에게 푸시 알림 전송 (지원 플랫폼에 따라)

지원 플랫폼

• Claude Code
• Cursor
• Codex
• 기타 AI 에이전트 플랫폼

설치 방법

1. 저장소 클론

git clone https://github.com/chjm-ai/stock-monitor.git

2. 종속 패키지 설치

cd stock-monitor
pip install -r requirements.txt

3. 환경 변수 설정

.env 파일을 만들어 다음 변수를 설정하세요:

STOCK_API_KEY=your_api_key
ALERT_WEBHOOK_URL=your_webhook_url
CHECK_INTERVAL=60  # 분 단위

설정 방법

config.yaml 파일에서 경보 규칙을 설정할 수 있습니다:

rules:
  cost_percent:
    enabled: true
    threshold: 5.0  # 원가 대비 ±5%
  moving_average:
    enabled: true
    short_period: 5
    long_period: 20
  rsi:
    enabled: true
    overbought: 70
    oversold: 30
  volume:
    enabled: true
    multiplier: 2.0  # 평균 거래량 대비 2배
  gap:
    enabled: true
    min_gap_percent: 1.0
  dynamic_take_profit:
    enabled: true
    trailing_stop: 5.0  # 최고가 대비 5% 하락 시 이익 실현

사용 예시

기본 모니터링 시작

python monitor.py --watchlist stocks.txt

백테스팅 실행

python backtest.py --config config.yaml --historical data.csv

라이선스

MIT License

작성자

chjm-ai