$git clone https://github.com/JungHoonGhae/tossinvest-cli> [!WARNING] > 이 프로젝트는 토스증권 공식 제품이 아닙니다. 공식 Open API 키를 연결하면 해당 기능은 토스가 공식 지원하는 경로로 동작하지만, 그 외 기능은 토스 웹 내부 API를 비공식적으로 사용하며 이는 토스증권 이용약관(TOS) 위반에 해당할 수 있습니다. API는 예고 없이 변경될 수 있고, 사용으로 인한 계좌 제한·손실·기타 불이익에 대해 개발자는 어떠한 책임도 지지 않습니다. 본인의 판단과 책임 하에 사용하세요.
| 1 | <p align="center"> |
| 2 | <a href="https://tossinvest-cli.vercel.app/"><img src="docs/assets/hero-banner-v5.png" alt="tossinvest-cli — connect your AI agents to Toss Securities" width="100%" /></a> |
| 3 | </p> |
| 4 | |
| 5 | <p align="right"><strong>한국어</strong> · <a href="README.en.md">English</a></p> |
| 6 | |
| 7 | <div align="center"> |
| 8 | <h1>tossinvest-cli</h1> |
| 9 | <p><strong>토스증권에 연결하는 가장 유연한 방법. CLI 로, MCP 서버로, 어떤 AI 에이전트로든 — 공식 API는 물론 웹앱에만 있던 기능까지 하나로.</strong></p> |
| 10 | <p>Claude Code · Codex · Gemini · Cursor · GitHub Copilot — 어떤 AI 에이전트로든 <code>tossctl</code> 하나로 토스증권 계좌·시세·거래를 다룹니다. <strong>MCP 서버(<code>tossctl mcp</code>)로 붙이거나 터미널에서 직접</strong>, <strong>공식 키 없이 바로 또는 연결 시 자동 라우팅.</strong></p> |
| 11 | <p><sub>수급 · 시장지수 · AI 시그널 · 조건검색 · 관심종목 관리 · 거래내역 ledger · 실시간 푸시 · 원화 소수점 주문 · dry-run preview 등 WTS 전용 기능 24가지 — <strong>공식 Open API 지원 범위도 물론 100% 포함합니다.</strong> <a href="#지원-범위">전체 비교표 ↓</a></sub></p> |
| 12 | <p><sub><em>The most flexible way to connect Toss Securities — via CLI, via MCP, from any AI agent. 100% of the official Open API, plus 24 features only the web app had.</em></sub></p> |
| 13 | </div> |
| 14 | |
| 15 | <p align="center"> |
| 16 | <a href="LICENSE"><img src="docs/assets/badges/license.svg" height="44" alt="License: MIT" /></a> |
| 17 | <a href="https://go.dev/"><img src="docs/assets/badges/go.svg" height="44" alt="Built with Go 1.25+" /></a> |
| 18 | <img src="docs/assets/badges/agents.svg" height="44" alt="Works with Claude · Codex · Cursor" /> |
| 19 | </p> |
| 20 | |
| 21 | <p align="center"> |
| 22 | <img src="docs/assets/badges/output.svg" height="44" alt="Output: JSON · CSV · SSE" /> |
| 23 | <a href="https://tossinvest-cli.vercel.app/docs/guide/hybrid-openapi"><img src="docs/assets/badges/hybrid.svg" height="44" alt="Routing: Official API + WTS" /></a> |
| 24 | </p> |
| 25 | |
| 26 | <p align="center"> |
| 27 | <a href="#빠른-시작"><strong>빠른 시작</strong></a> · |
| 28 | <a href="#지원-범위"><strong>지원 범위</strong></a> · |
| 29 | <a href="#명령-목록"><strong>명령 목록</strong></a> · |
| 30 | <a href="#faq"><strong>FAQ</strong></a> · |
| 31 | <a href="#문서"><strong>문서</strong></a> · |
| 32 | <a href="#후원"><strong>후원</strong></a> |
| 33 | </p> |
| 34 | |
| 35 | <p align="center"> |
| 36 | <a href="https://github.com/JungHoonGhae/tossinvest-cli/stargazers"><img src="https://img.shields.io/github/stars/JungHoonGhae/tossinvest-cli" alt="GitHub stars" /></a> |
| 37 | <a href="https://github.com/JungHoonGhae/tossinvest-cli"><img src="https://img.shields.io/badge/status-beta-orange.svg" alt="Status Beta" /></a> |
| 38 | <a href="https://github.com/JungHoonGhae/tossinvest-cli/actions/workflows/ci.yml"><img src="https://github.com/JungHoonGhae/tossinvest-cli/actions/workflows/ci.yml/badge.svg" alt="CI" /></a> |
| 39 | </p> |
| 40 | |
| 41 | > [!WARNING] |
| 42 | > 이 프로젝트는 토스증권 공식 제품이 아닙니다. 공식 Open API 키를 연결하면 해당 기능은 토스가 공식 지원하는 경로로 동작하지만, 그 외 기능은 토스 웹 내부 API를 비공식적으로 사용하며 이는 토스증권 이용약관(TOS) 위반에 해당할 수 있습니다. API는 예고 없이 변경될 수 있고, 사용으로 인한 계좌 제한·손실·기타 불이익에 대해 개발자는 어떠한 책임도 지지 않습니다. 본인의 판단과 책임 하에 사용하세요. |
| 43 | |
| 44 | > [!IMPORTANT] |
| 45 | > 거래 기능은 설치 직후 모두 꺼져 있습니다. `config.json`에서 기능별로 직접 허용해야만 실행됩니다. |
| 46 | |
| 47 | <div align="center"> |
| 48 | <sub><strong>WORKS WITH</strong></sub> |
| 49 | <br /><br /> |
| 50 | <img src="docs/assets/logos/claude.svg" height="30" alt="Claude Code" title="Claude Code" /> |
| 51 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/logos/codex.svg" /><img src="docs/assets/logos/codex-light.svg" height="30" alt="Codex" title="Codex" /></picture> |
| 52 | <img src="docs/assets/logos/googlegemini.svg" height="30" alt="Gemini CLI" title="Gemini CLI" /> |
| 53 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/logos/cursor.svg" /><img src="docs/assets/logos/cursor-light.svg" height="30" alt="Cursor" title="Cursor" /></picture> |
| 54 | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/logos/githubcopilot.svg" /><img src="docs/assets/logos/githubcopilot-light.svg" height="30" alt="GitHub Copilot" title="GitHub Copilot" /></picture> |
| 55 | <img src="docs/assets/logos/opencode.svg" height="30" alt="OpenCode" title="OpenCode" /> |
| 56 | <img src="docs/assets/logos/qwen.svg" height="30" alt="Qwen Code" title="Qwen Code" /> |
| 57 | <img |