JungHoonGhae/tossinvest-cli

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

解決的問題

tossinvest-cli 提供了一種連接 Toss Securities 的靈活方式，擴展了官方 Open API 的功能。它允許使用者透過命令列介面 (CLI) 或作為 AI 代理的 MCP 伺服器來存取帳戶摘要、投資組合、市場數據與交易功能，彌補了受限的官方 API 與 Toss Web App (WTS) 中提供的完整功能集之間的差距。

工作原理

該工具使用 Go 語言建構，作為 CLI (tossctl) 與 MCP 伺服器運行。它可以透過官方 API 金鑰或利用 Web 會話（透過 QR 登入）連接到 Toss Securities，從而存取官方 API 中無法使用的功能。它在 config.json 中包含了一個安全閘門，預設禁用交易操作，執行交易需要使用者的明確許可。

適用對象

AI 代理使用者：使用 Claude Code、Cursor、Gemini 或 GitHub Copopit，並希望其代理透過 MCP 管理帳戶與交易的使用者。
開發者與自動化使用者：希望透過程式化方式存取 Toss Securities 數據用於腳本、儀表板或自動交易的使用者。
投資者：尋求官方 API 中未提供的已實現損益、股息與市場供需流等進階分析工具的個人。

亮點

擴展覆蓋範圍：支持 100% 的官方 Open API 以及來自 Web App 的 24 項額外功能，如 AI 訊號、市場指數與股息歷史。
AI 代理整合：原生支援 MCP (Model Context Protocol)，允許透過各種 AI 代理與 Toss Securities 進行自然語言互動。
混合路由：自動透過官方 API 或 Web 會話路由請求，以繞過速率限制並存取受限功能。
全面的交易功能：支援限價單、碎股（包括 KRW 支付模式）以及用於交易驗證的「模擬執行預覽」。
無頭登入：支援在沒有 GUI 的環境（SSH/CI）中使用基於 QR 的身分驗證。