JungHoonGhae/tossinvest-cli

解决的问题

tossinvest-cli 提供了一种灵活的方式连接 Toss Securities，使用户可以通过命令行界面（CLI）或作为 AI 代理的模型上下文协议（MCP）服务器来管理账户、查看市场报价并执行交易。它弥合了有限的官方 Open API 与 Toss 网络交易系统（WTS）中完整功能集之间的差距，提供的功能远超官方 API 本身。

工作原理

该工具使用 Go 构建，作为混合路由系统运行。对于支持的功能，它使用官方 Open API；对于其他请求，则通过 Toss 网络应用的内部 API（WTS）进行路由。用户通过浏览器端的二维码登录或链接登录进行认证。为确保安全，交易功能默认禁用，必须在 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）、带有“韩元溢价”的加密货币价格，以及海外股票的详细税务报告。