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 Copilot，并希望其代理通过 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 的身份验证。