JungHoonGhae/tossinvest-cli

解决的问题

此项目提供了一个命令行界面 (CLI) 与模型上下文协议 (MCP) 服务器，用于访问 Toss Securities 的投资数据。它弥补了官方 Open API 与 Toss Securities 网页平台 (WTS) 上完整信息之间的差距，让用户能够访问超过 30 种官方 API 未提供的额外功能，例如 AI 信号、股息历史与税务数据。

运作方式

tossctl 作为一个封装工具，同时连接官方 Open API 与非官方网页内部 API (WTS)。它允许用户通过手机验证进行身份验证并维持连接。一旦连接，它既可作为独立的 CLI 工具用于脚本与终端查询，也可作为 MCP 服务器，将 AI 代理 (如 Claude Code、Cursor 或 Codex) 连接到用户的投资数据，从而实现关于资产、新闻与绩效的自然语言查询。

目标对象

使用 Toss Securities 并希望自动化投资组合追踪、将财务数据整合至 AI 驱动工作流程，或直接从终端访问进阶投资分析工具的投资者。

特色亮点

• 扩展功能集：访问超过 30 种官方 API 未包含的功能，包括 AI 信号、财报会议与税务信息。
• AI 代理整合：内置 MCP 服务器支持，可与 Claude Code 与 Cursor 等 AI 代理无缝连接。
• 混合 API 方法：优先使用官方 Open API 密钥，并在需要扩展功能时回退至 WTS 内部 API。
• 安全第一：默认停用实际交易；订单必须经过预览并由用户手动确认。
• 本地历史记录：能够离线同步与搜索投资历史记录。