JungHoonGhae/tossinvest-cli

해결하는 문제

tossinvest-cli 는 Toss Securities 에 유연하게 연결할 수 있는 방법을 제공하여, 사용자가 명령줄 인터페이스 (CLI) 또는 AI 에이전트를 위한 Model Context Protocol (MCP) 서버를 통해 계좌 관리, 시장 가격 확인, 거래 실행이 가능하게 합니다. 공식 Open API 의 제한된 기능과 Toss 웹 트레이딩 시스템 (WTS) 에서 제공하는 전체 기능 세트 사이의 격차를 메우며, 공식 API 만으로는 제공되지 않는 훨씬 더 많은 기능을 제공합니다.

작동 방식

이 도구는 Go 로 구현되어 하이브리드 라우팅 시스템으로 작동합니다. 지원되는 기능은 공식 Open API 를 사용하고, 그렇지 않은 요청은 Toss 웹 애플리케이션의 내부 API (WTS) 를 통해 라우팅합니다. 사용자는 브라우저 기반 QR 로그인 또는 링크 로그인을 통해 인증합니다. 보안을 위해 거래 기능은 기본적으로 비활성화되어 있으며, config.json 파일에서 명시적으로 활성화해야 합니다. 또한, 자주 재로그인하지 않고도 연결을 유지하기 위한 세션 연장 메커니즘 (tossctl auth extend) 도 포함되어 있습니다.

대상 사용자

• AI 에이전트 사용자: Claude Code, Cursor, Gemini, GitHub Copilot 를 사용하며, AI 에이전트가 MCP 서버를 통해 증권 거래 및 시장 분석을 수행할 수 있도록 하고 싶은 사용자.
• 개발자 및 자동화 사용자: 스크립팅, 자동화, 또는 공식 API 에 포함되지 않은 실시간 푸시 및 세부 포트폴리오 성과 데이터에 접근이 필요한 사용자.
• 소규모 투자자: Toss Securities 사용자로서 투자를 프로그래밍 방식으로 관리하고 싶은 사용자.

주요 특징

• 확장된 기능: 공식 Open API 의 100% 를 커버하며, AI 신호, 조건 검색, 세부 거래 내역 기록 등 총 58개의 추가 고유 기능 제공.
• AI 에이전트 통합: MCP 에 대한 네이티브 지원으로 AI 에이전트가 자연어로 Toss Securities 와 상호작용 가능.
• 하이브리드 라우팅: 공식 API 와 WTS 내부 API 간을 원활하게 전환 가능.
• 안전 우선: 거래 변경은 명시적인 구성과 dry-run preview 가 필요하며, 실행 전 확인 가능.
• 포괄적인 데이터: 실시간 푸시 (SSE), "Kimchi 프리미엄" 포함 암호화 자산 가격, 해외 주식에 대한 세부 세금 보고서에 접근 가능.