# Auto Stock Trading System - 사용 가이드

## 기능 소개

### 1. 대시보드
- 실시간 포트폴리오 현황
- 총 자산 및 수익률 모니터링
- 보유 종목 상세 정보

### 2. 전략 룰 설정
- 자동 매매 규칙 생성/수정/삭제
- 규칙 활성화/비활성화
- 조건 및 액션 설정

### 3. 매매 로그
- 모든 거래 내역 조회
- 실행 상태 확인
- 거래 통계

### 4. MCP 상태 모니터
- MCP 서버 연결 상태
- 사용 가능한 도구 목록
- 실시간 MCP 로그

## 트레이딩 규칙 생성 가이드

### 규칙 구조

```json
{
  "name": "규칙 이름",
  "description": "규칙 설명",
  "rule_type": "BUY" | "SELL",
  "conditions": {
    // 실행 조건
  },
  "actions": {
    // 실행할 액션
  }
}
```

### 조건 예시

#### RSI 기반 매수
```json
{
  "conditions": {
    "rsi_below": 30,
    "volume_above_average": 1.5
  }
}
```

#### 손절매
```json
{
  "conditions": {
    "loss_rate_below": -5
  }
}
```

#### 익절
```json
{
  "conditions": {
    "profit_rate_above": 15
  }
}
```

### 액션 예시

#### 매수 액션
```json
{
  "actions": {
    "order_type": "BUY",
    "quantity_percent": 10,
    "max_amount": 1000000
  }
}
```

#### 매도 액션
```json
{
  "actions": {
    "order_type": "SELL",
    "quantity_percent": 100
  }
}
```

## Claude AI 분석 활용

### 1. 규칙 검증
시장 상황에 맞게 규칙이 적절한지 Claude AI가 분석합니다.

### 2. 시장 분석
기술적 지표와 뉴스를 종합하여 시장 트렌드를 분석합니다.

### 3. 리스크 평가
포트폴리오와 거래 계획을 분석하여 리스크를 평가합니다.

## MCP 도구

### get_market_data
시장 데이터를 조회합니다.

```json
{
  "tool_name": "get_market_data",
  "parameters": {
    "stock_code": "005930",
    "period": "D"
  }
}
```

### calculate_indicators
기술적 지표를 계산합니다.

```json
{
  "tool_name": "calculate_indicators",
  "parameters": {
    "price_data": [...],
    "indicators": ["RSI", "MACD", "BB"]
  }
}
```

### check_portfolio
현재 포트폴리오를 확인합니다.

```json
{
  "tool_name": "check_portfolio",
  "parameters": {}
}
```

### execute_order
주문을 실행합니다.

```json
{
  "tool_name": "execute_order",
  "parameters": {
    "stock_code": "005930",
    "order_type": "BUY",
    "quantity": 10,
    "price": 71000
  }
}
```

## 모범 사례

### 1. 리스크 관리
- 한 종목에 총 자산의 10% 이상 투자하지 않기
- 손절매 규칙 반드시 설정
- 일일 최대 거래 횟수 제한

### 2. 규칙 우선순위
- 손절매: 최고 우선순위 (100)
- 익절: 높은 우선순위 (90)
- 일반 매매: 중간 우선순위 (10-50)

### 3. 백테스팅
새로운 규칙은 과거 데이터로 먼저 테스트하세요.

### 4. 모니터링
- 실시간 로그 확인
- 규칙 성과 정기 검토
- MCP 서버 연결 상태 체크

## 주의사항

⚠️ **중요**: 이 시스템은 자동 매매를 수행합니다.
- 실제 계좌로 사용하기 전에 충분히 테스트하세요
- 시장 상황을 항상 모니터링하세요
- 규칙을 신중하게 설정하세요
- 손실 위험을 항상 고려하세요

## 문제 해결

### Q: 거래가 실행되지 않아요
A: 
1. 규칙이 활성화되어 있는지 확인
2. 조건이 충족되었는지 확인
3. 계좌 잔액 확인
4. API 연결 상태 확인

### Q: MCP 서버가 연결되지 않아요
A:
1. MCP 서버가 실행 중인지 확인
2. Claude API 키가 올바른지 확인
3. 네트워크 연결 확인

### Q: 포트폴리오가 동기화되지 않아요
A:
1. "포트폴리오 동기화" 버튼 클릭
2. API 키와 계좌번호 확인
3. 한국투자증권 API 상태 확인

## 지원

문제가 발생하거나 도움이 필요하시면 GitHub Issues에 문의해주세요.