Kiwoom Broker

키움증권 공식 CLI를 증권사 어댑터로 사용한다. 인증·토큰·API 필드 매핑은 CLI에 맡기고, 이 스킬은 명령 선택과 안전 경계를 담당한다.

실행 전 점검

설치한 일반 터미널과 Hermes 세션의 PATH·HOME·Keyring은 다를 수 있다. 따라서 조회나 주문 전에 현재 Hermes 세션 안에서 아래 preflight를 수행한다.

1. command -v kiwoomcli로 실행 파일을 찾는다.

2. 없으면 $HOME/.local/bin/kiwoomcli가 실행 가능한지 확인한다. 이 폴백이 성공하면 해당 세션의 PATH 문제로 보고하고 절대 경로로 실행한다.

3. 둘 다 없으면 실행하지 말고 다음 설치 명령을 안내한다.

   uv tool install kwcli
   uv tool update-shell