JungHoonGhae/tossinvest-cli

해결하는 문제

이 프로젝트는 Toss Securities 투자 데이터에 액세스하기 위한 명령줄 인터페이스(CLI) 및 Model Context Protocol(MCP) 서버를 제공합니다. 공식 Open API와 Toss Securities 웹 플랫폼(WTS)에서 제공되는 정보 사이의 간극을 메워주며, AI 신호, 배당 내역, 세금 데이터 등 공식 API에서는 사용할 수 없는 30개 이상의 추가 기능에 액세스할 수 있게 합니다.

작동 방식

tossctl은 공식 Open API와 비공식 웹 내부 API(WTS) 모두에 연결되는 래퍼 역할을 합니다. 사용자는 휴대폰 인증을 통해 로그인하고 세션을 유지할 수 있습니다. 연결이 완료되면 스크립트 및 터미널 쿼리를 위한 독립형 CLI 도구로 사용하거나, AI 에이전트(Claude Code, Cursor, Codex 등)를 사용자의 투자 데이터에 연결하여 자산, 뉴스, 성과에 대한 자연어 쿼리를 가능하게 하는 MCP 서버로 활용할 수 있습니다.

대상 사용자

포트폴리오 추적을 자동화하고, 금융 데이터를 AI 기반 워크플로우에 통합하거나, 터미널에서 직접 고급 투자 분석 도구에 액세스하려는 Toss Securities 사용자.

주요 특징

• 확장된 기능 세트: AI 신호, 실적 발표, 세금 정보 등 공식 API에 없는 30개 이상의 기능에 액세스.
• AI 에이전트 통합: Claude Code 및 Cursor와 같은 AI 에이전트와 원활하게 연결할 수 있는 내장 MCP 서버 지원.
• 하이브리드 API 접근 방식: 공식 Open API 키를 우선적으로 사용하며, 확장 기능이 필요한 경우 WTS 내부 API로 대체.
• 안전 우선: 실제 거래는 기본적으로 비활성화되어 있으며, 주문은 미리보기 후 사용자가 수동으로 승인해야 함.
• 로컬 기록: 투자 기록을 오프라인으로 동기화하고 검색하는 기능.