// KIS 인증이 필요할 때 반드시 사용. '인증해줘', '모의투자 인증', '실전 인증', '토큰 갱신', 'auth vps', 'auth prod', 'auth switch'라고 할 때 자동 실행된다.
| name | auth |
| description | KIS 인증이 필요할 때 반드시 사용. '인증해줘', '모의투자 인증', '실전 인증', '토큰 갱신', 'auth vps', 'auth prod', 'auth switch'라고 할 때 자동 실행된다. |
프로젝트 루트의 scripts/ 에 있다. 실행 시 절대 경로를 사용한다.
먼저 pwd로 현재 디렉토리를 확인하고, 프로젝트 루트를 기준으로 경로를 구성한다.
uv run <프로젝트루트>/.codex/scripts/auth.pyuv run <프로젝트루트>/.codex/scripts/do_auth.py <인자>| 입력 | 동작 |
|---|---|
모의, vps, paper | 모의투자 REST 인증 |
실전, prod, real | 실전투자 REST 인증 |
ws 모의, ws vps | 모의투자 WebSocket 인증 |
ws 실전, ws prod | 실전투자 WebSocket 인증 |
switch, 전환 | 현재 모드 반대로 전환 (모의↔실전) |
| 인자 없음 | 현재 상태 확인 후 사용자에게 물어본다 |
auth.py 실행 — 현재 상태 확인do_auth.py 호출
do_auth.py <vps|prod>do_auth.py ws <vps|prod>do_auth.py switchsuccess 확인 후 결과 안내auth.py 재실행 — 정상 반영 확인prod) 인증 시에는 반드시 사용자에게 한 번 더 확인을 받는다.switch) 시에는 기존 토큰이 삭제됨을 안내한다.KIS 플러그인 사용법을 안내할 때 사용. '사용법', '도움말', '커맨드 목록', '오류코드', 'kis-help'라고 할 때 자동 실행된다.
KIS 환경을 진단하거나 설치할 때 반드시 사용. '환경 확인', '설치해줘', 'setup', 'kis-setup'이라고 할 때 자동 실행된다.
KIS 계좌 상태를 조회할 때 반드시 사용. '잔고 확인', '보유종목', '내 계좌', '지수 확인', 'my-status'라고 할 때 자동 실행된다.
KIS 전략을 과거 데이터로 검증하거나 성과를 확인할 때 반드시 사용. '백테스팅', '백테스트 해줘', '전략 검증', '성과 분석', '파라미터 최적화', '수익률 확인', '과거 검증', '샤프 확인', '최대낙폭 보고 싶어', '이 전략 수익률이 어떻게 돼?'라고 할 때 자동 실행된다. backtester MCP 서버를 통해 10개 프리셋(sma_crossover, momentum 등) 또는 .kis.yaml 전략 실행, BacktestResult(총수익률·CAGR·최대낙폭·샤프) 해석, Grid/Random 파라미터 최적화, 배치 전략 비교, 포트폴리오 분석, HTML 리포트 생성을 수행한다.
Handle KIS customer-service style support. Use when users are confused, report errors, ask unsupported/illegal requests, request direct stock picks, or need policy-safe alternatives.
KIS 전략의 실시간 신호를 확인하거나 주문을 실행할 때 반드시 사용. '전략 실행해줘', '신호 확인', '종목 돌려봐줘', '매수 신호 있어?', '매도 타이밍', '실시간 매매', '자동매매', '삼성전자 지금 들어가도 돼?', '이 전략으로 주문 넣어줘'라고 할 때 자동 실행된다. 종목 코드를 먼저 선택한 뒤 전략을 실행해 BUY·SELL·HOLD 신호와 강도(0~1)를 확인하고, 신호 강도에 따라 모의(vps)/실전(prod) 주문을 실행한다. 실전투자 주문 전 반드시 사용자 확인을 받는다.