Skip to main content
Glama
dongju923
by dongju923

KISPilot

한국투자증권 Open API를 AI 에이전트(MCP) 와 웹 콘솔에서 쓰기 위한 도구 모음입니다.

비공식 프로젝트입니다. 한국투자증권과 관계가 없으며, 한국투자증권이 만들거나 검증하지 않았습니다. 이 소프트웨어는 투자 조언이 아니며, 주문·백테스트 결과로 생긴 손실에 대해 책임지지 않습니다 (MIT 라이선스, 무보증). 실전 계좌로 쓰기 전에 모의투자로 충분히 확인하세요.

할 수 있는 것

  • 조회 — 시세·호가·체결, 투자자·수급, 재무, 순위, 업종·지수, ETF, 계좌 잔고·손익 (KIS API 80여 개)

  • 선물·옵션 — KOSPI200 선물·옵션(미니·위클리 포함) 주간·야간 전광판, 실시간 호가·체결, 차트

  • 주문 — 현금·신용·예약 주문, 정정·취소 (에이전트는 모의투자가 기본, 실전은 2단계 확인)

  • 차트 — 1분~년봉, 이동평균·볼린저·일목균형표 등 지표, 보조 차트 30여 종

  • 백테스트 — 기본 전략 11종 + 지표 157개로 만드는 커스텀 전략, 여러 전략 비교, 여러 종목 포트폴리오

  • 실시간 — KIS 웹소켓 체결·호가 (웹 콘솔)

Related MCP server: KIS MCP Server

화면

kispilot ui 로 여는 웹 콘솔입니다. 이미지를 누르면 크게 볼 수 있습니다. (계좌가 나오는 화면은 모의투자 계좌, 계좌번호는 가렸습니다)

시장

종목 · 파생

매매 · 전략

AI 에이전트로 물어보면

같은 질문 — "삼성전자 최근 5일 외인, 기관 수급 동향 파악해줘" — 을 MCP 없이, 그리고 KISPilot MCP 를 연결해서 물어본 결과입니다.

빠른 시작

Python 3.11 이상이 필요합니다.

1. 설치

uv tool install kispilot      # 또는: pipx install kispilot / pip install kispilot

2. 키 등록 (처음 한 번) — KIS Developers에서 앱키·앱시크릿을 발급받은 뒤:

kispilot setup        # 실전 / 모의투자 / 둘 다 선택 → 앱키·시크릿·계좌 입력

앱키는 OS 키체인에 저장됩니다. 키를 AI 채팅창에 붙여넣지 마세요.

3. 쓰는 방법 고르기

이렇게 쓰려면

실행

웹 화면에서 직접 보기

kispilot ui → http://127.0.0.1:8000

Claude 등 AI 에이전트에게 맡기기

kispilot install claude-desktop (Claude Code · Cursor · VS Code · Gemini CLI · Codex 도 지원) 후 앱 다시 시작

안내 문서

문서

이럴 때 보세요

설치 · 키 등록

업데이트·삭제, 소스 설치, 서버처럼 키체인이 없는 환경, 데이터 저장 위치

웹 콘솔

화면마다 무엇을 볼 수 있는지, 다른 기기에서 접속하기

선물 · 옵션

KOSPI200 선물·옵션 전광판, 주간/야간, 알아 둘 점

AI 에이전트 (MCP)

클라이언트별 등록, 도구·프롬프트 목록, 직접 설정, 주문 안전장치

버전별 변경 내용은 Releases 에 있습니다.

데이터 출처 · 참고

라이선스

MIT

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables interaction with the Korea Investment & Securities (KIS) Open API for domestic and overseas stock trading, real-time market data, and automated strategy execution. It provides a structured interface for LLMs to perform trading operations, manage portfolios, and conduct backtesting.
    -
  • F
    license
    A
    quality
    D
    maintenance
    Enables Claude to trade Korean and overseas stocks, check balances, and search stock information through the Korea Investment & Securities Open API.
    12
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables querying Korean and US stock information, quotes, account assets, and order history via Toss Securities Open API. Optionally supports order placement with preview and confirmation safeguards.
    1
    MIT
  • F
    license
    Not graded
    quality
    F
    maintenance
    Provides real-time Korean stock market data, including stock prices, rankings, investor trends, and derivatives, via the Korea Investment & Securities OpenAPI. Enables AI models to query and analyze Korean financial data through natural language.
    -