shuim 5b80223777 feat: 실적 필터 메커니즘 (Phase 2, 기본 OFF)
실적을 매매 기준에 반영하는 필터를 추가하되 기본 비활성(OFF). 적자(EPS<0)·
하락전망(컨센서스 목표가 대비 상승여력 부족) 종목의 진입을 차단한다. 데이터원은
네이버(get_stock_fundamentals, Phase 1 재사용, 10분 캐시).

- config: FUNDAMENTAL_FILTER_ENABLED=False(기본), FUNDAMENTAL_BLOCK_NEGATIVE_EPS,
  FUNDAMENTAL_MIN_UPSIDE_PCT.
- _execute_buy: 필터 ON일 때만 주문 전 실적 스크리닝, 실패 시 차단 안 함(안전).
  차단 사유는 관측성 로그로 노출(fundamental_negative_eps / fundamental_low_upside).

⚠️ 켜기 전 필수: point-in-time 실적 데이터(OpenDART)로 백테스트 검증
(CLAUDE.md §8.1-4). 네이버 현재값은 룩어헤드라 백테스트 부적합 → 검증 후 ON.
현재는 OFF라 라이브 동작 변화 없음.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HBmzf1HDnvFHLraJ8eaaKJ
2026-09-16 14:13:04 +09:00
2026-04-09 08:42:57 +09:00
2025-11-14 11:05:31 +09:00
2026-02-23 16:01:17 +09:00
2026-03-28 11:45:37 +09:00
2026-02-24 11:38:35 +09:00
2026-02-22 17:23:20 +09:00
2026-04-06 13:16:15 +09:00
2026-03-27 14:47:49 +09:00
2026-02-26 11:19:23 +09:00
2026-02-26 14:40:12 +09:00
2026-03-28 11:45:37 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00
2026-04-01 11:04:52 +09:00
2025-11-14 11:05:31 +09:00
2026-02-26 14:40:12 +09:00
2026-04-02 11:31:01 +09:00
2026-02-26 11:19:23 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00
2026-02-26 14:40:12 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00
2026-02-22 17:23:20 +09:00

Auto Stock Trading System with MCP

Claude AI와 MCP(Model Context Protocol)를 활용한 한국 주식 자동매매 시스템

시스템 아키텍처

  • Frontend: React + TypeScript + Vite
  • Backend: Python FastAPI + WebSocket
  • MCP Server: Claude AI 통합
  • Database: PostgreSQL
  • Cache: Redis
  • Message Queue: RabbitMQ
  • API: 한국투자증권 API

주요 기능

  1. 실시간 시장 데이터 수집
  2. Claude AI 기반 규칙 검증
  3. 자동 매매 실행
  4. 포트폴리오 관리
  5. 실시간 모니터링

프로젝트 구조

auto-stock/
├── frontend/          # React 프론트엔드
├── backend/           # FastAPI 백엔드
├── mcp-server/        # MCP 서버
├── docker/            # Docker 설정
└── scripts/           # 배포 스크립트

빠른 시작

# 환경 변수 설정
cp .env.example .env

# 기본값
#  - `DATABASE_URL`은 `.env.example`에 이미 도커 컨테이너(127.0.0.1:5432)를
#    가리키도록 설정되어 있습니다. 로컬 개발 시 별도 수정이 필요 없습니다.
#    원격 DB를 사용하려면 여기에 URL을 덮어쓰십시오.

# Docker로 전체 시스템 시작
./scripts/deploy.sh

# 개발 모드
./scripts/dev.sh

환경 변수

.env 파일에 다음 설정 필요:

  • KOREA_INVESTMENT_APP_KEY: 한국투자증권 앱키
  • KOREA_INVESTMENT_APP_SECRET: 한국투자증권 시크릿
  • ANTHROPIC_API_KEY: Claude API 키
  • DATABASE_URL: PostgreSQL 연결 URL (기본값은 도커 컨테이너)
  • REDIS_URL: Redis 연결 URL

라이센스

MIT

Description
No description provided
Readme 11 MiB
Languages
Python 90.6%
TypeScript 8.6%
Shell 0.5%
CSS 0.1%