用途:把 Kiwoom 官方 CLI 作为券商适配器,由 CLI 处理认证、令牌和 API 字段映射,本技能只负责命令选择与安全边界。用于查询韩国 ETF/股票行情、日线数据、持仓,以及下单预览与审批后执行。
能力:支持 domestic etfs info、domestic candles daily、domestic accounts holdings 等查询,以及 domestic orders buy/sell 的订单草稿与 --confirm 执行;提供 auth status 与 doctor 诊断。
用法:查询前先做 preflight:用 command -v kiwoomcli 查找可执行文件;若无则尝试 $HOME/.local/bin/kiwoomcli,仍无则提示安装:uv tool install kwcli 和 uv tool update-shell。首次设置由用户在交互终端运行 kiwoomcli setup,且须与 Hermes 同一主机、同一 OS 用户;凭据存入系统凭据库,不创建 .env。随后运行 kiwoomcli auth status --profile 모의계좌 与 kiwoomcli doctor,按输出标签原样转述账户别名、模式、凭据存在、凭据来源、令牌有效、现在可调用 API;若矛盾或非“是”则停止。查询示例:kiwoomcli domestic etfs info --code 069500 --profile 모의계좌 --format json。不确定命令时用 kiwoomcli spec search,并检查 return_code 是否为 0。
订单:先不加 --confirm 生成未发送预览,仅在 CLI 确认尚未发送时视为草稿;向用户复述标的、数量、价格、订单类型、模式并请求审批。审批后且各项与预览一致、存在 OrderIntent 与 ApprovalRecord、配置文件为模拟且服务器为 demo 时,才在相同命令加 --confirm。
限制:禁止用 curl 或自写 Python 直连 Kiwoom REST API,禁止自建令牌缓存,禁止未经明确审批加 --confirm,禁止把失败响应总结为成功,禁止绕过 CLI 默认安全措施。不输出凭据、令牌或账号原文。真实账户不属于本技能默认范围。策略判断、订单意图生成、审批记录、防重与成交对账由 magma-finance-lab 承担。