JungHoonGhae/tossinvest-cli

토스증권을 AI 에이전트와 터미널에서 다루는 도구. CLI 와 MCP 서버로 계좌·시세·주문은 물론 웹앱 전용 기능(수급·AI 시그널·스크리너·배당)까지, JSON·CSV 구조화 출력으로 AI 도구·자동화에 바로 연동.

해결하는 문제

tossinvest-cli는 Toss 증권에 연결하는 유연한 방법을 제공하여 공식 Open API의 기능을 확장합니다. 사용자가 명령줄 인터페이스(CLI) 또는 AI 에이전트를 위한 MCP 서버를 통해 계좌 요약, 포트폴리오, 시장 데이터 및 거래 기능에 액세스할 수 있도록 하여, 제한된 공식 API와 Toss 웹 앱(WTS)에서 제공되는 전체 기능 세트 사이의 간극을 메웁니다.

작동 방식

이 도구는 Go로 구축되었으며 CLI (tossctl) 및 MCP 서버로 작동합니다. 공식 API 키를 사용하거나 웹 세션(QR 로그인 방식)을 활용하여 Toss 증권에 연결할 수 있어, 공식 API에서 사용할 수 없는 기능에도 액세스할 수 있습니다. config.json에 안전 장치를 포함하여 기본적으로 거래 동작을 비활성화하며, 거래를 실행하려면 명시적인 사용자 허용이 필요합니다.

대상 사용자

AI 에이전트 사용자: Claude Code, Cursor, Gemini 또는 GitHub Copilot를 사용하며, 에이전트가 MCP를 통해 계좌 및 거래를 관리하기를 원하는 사용자.
개발자 및 자동화 사용자: 스크립트, 대시보드 또는 자동 매매를 위해 프로그래밍 방식으로 Toss 증권 데이터에 액세스하려는 사용자.
투자자: 공식 API에는 없는 실현 손익, 배당금, 시장 수급 흐름에 대한 고급 분석 도구를 찾는 개인.

주요 특징

확장된 커버리지: 공식 Open API의 100%를 지원할 뿐만 아니라 AI 시그널, 시장 지수, 배당 내역 등 웹 앱의 24가지 추가 기능을 지원합니다.
AI 에이전트 통합: MCP (Model Context Protocol)를 기본 지원하여 다양한 AI 에이전트를 통해 Toss 증권과 자연어로 상호작용할 수 있습니다.
하이브리드 라우팅: 요청을 공식 API 또는 웹 세션으로 자동 라우팅하여 속도 제한을 우회하고 제한된 기능에 액세스합니다.
포괄적인 거래 기능: 지정가 주문, 소수점 주식(KRW 결제 모드 포함) 및 거래 검증을 위한 "드라이 런 미리보기"를 지원합니다.
헤드리스 로그인: GUI가 없는 환경(SSH/CI)을 위해 QR 기반 인증을 지원합니다.