JungHoonGhae/tossinvest-cli

解決的問題

tossinvest-cli 提供了一種靈活的方式連接 Toss Securities，讓使用者可以透過命令列介面（CLI）或作為 AI 代理的模型上下文協定（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 的使用者，希望其代理透過 MCP 伺服器處理證券買賣和市場分析。
• 開發者與自動化使用者：需要 CLI 進行腳本編寫、自動化，或存取官方 API 未提供的即時推送和詳細投資組合表現資料的使用者。
• 零售投資者：Toss Securities 使用者，希望以程式化方式管理其投資。

主要亮點

• 功能擴展：涵蓋 100% 的官方 Open API，外加 58 項獨特的額外功能（如 AI 信號、條件搜尋和詳細帳本歷史）。
• AI 代理整合：原生支援 MCP，允許 AI 代理使用自然語言與 Toss Securities 互動。
• 混合路由：在官方 API 與 WTS 內部 API 之間無縫切換。
• 安全為先：交易變更需要明確配置和 dry-run preview 才能執行。
• 全面資料：可存取即時推送（SSE）、帶有「韓元溢價」的加密貨幣價格，以及海外股票的詳細稅務報告。