// KIS 플러그인 사용법을 안내할 때 사용. '사용법', '도움말', '커맨드 목록', '오류코드', 'kis-help'라고 할 때 자동 실행된다.
KIS 인증이 필요할 때 반드시 사용. '인증해줘', '모의투자 인증', '실전 인증', '토큰 갱신', 'auth vps', 'auth prod', 'auth switch'라고 할 때 자동 실행된다.
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) 주문을 실행한다. 실전투자 주문 전 반드시 사용자 확인을 받는다.
| name | kis-help |
| description | KIS 플러그인 사용법을 안내할 때 사용. '사용법', '도움말', '커맨드 목록', '오류코드', 'kis-help'라고 할 때 자동 실행된다. |
$ARGUMENTS가 있으면 해당 키워드로 필터해서 보여준다.
없으면 "안녕하세요 고객님! 한국투자증권 openapi입니다. 무엇을 도와드릴까요?" 라고 말한 후 사용법을 안내한다.
| 트리거 문구 | 스킬 | 단계 | 주요 기능 |
|---|---|---|---|
| "전략 만들어줘", "YAML 전략" | kis-strategy-builder | Step 1 | 10개 프리셋 또는 커스텀 .kis.yaml 생성 |
| "백테스트 해줘", "수익률 확인" | kis-backtester | Step 2 | 과거 성과 검증, 파라미터 최적화, HTML 리포트 |
| "신호 확인", "매수 신호 있어?" | kis-order-executor | Step 3 | BUY/SELL/HOLD 신호 → 모의/실전 주문 |
| "다 해줘", "전략부터 주문까지" | kis-team | 1→2→3 | 3단계 전체 오케스트레이션 |
| $auth, "auth vps" | auth | — | 모의/실전 인증 |
| "잔고 확인", "보유종목" | my-status | — | 잔고·보유종목·지수 조회 |
| "환경 확인", "setup" | kis-setup | — | 환경 진단 및 자동 설치 |
# 처음 시작
$auth vps → auth 스킬
"잔고 확인해줘" → my-status 스킬
# 전략 설계 → 검증 → 실행
"RSI 전략 만들어줘" → kis-strategy-builder
"백테스트 해줘" → kis-backtester
"삼성전자 신호 확인해줘" → kis-order-executor
# 한 번에 다
"전략부터 주문까지 다 해줘" → kis-team
| 상황 | 코드 | 해결책 |
|---|---|---|
| API 너무 빠르게 호출 | EGW00201 | 초당 1건 이하로 제한 |
| 토큰 만료 | EGW00103/105 | $auth vps 또는 $auth prod |
| 모의투자인데 TR_ID가 T로 시작 | EGW00213 | TR_ID를 V로 변경 |
| WebSocket 중복 연결 | OPSP8996 | 기존 연결 종료 후 재연결 |
| 세션 끊김 | OPSQ1002 | $auth로 재인증 |
| API 권한 없음 | EGW00206 | KIS OpenAPI 신청 필요 |