Skip to content
Back to search

tossinvest-cli

공식 API에 없는 30+ 기능까지, 터미널과 AI에서 쓰세요. 토스증권 비공식 CLI·MCP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/JungHoonGhae/tossinvest-cli with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/JungHoonGhae/tossinvest-cli'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/junghoonghae--tossinvest-cli/badge.svg)](/listings/junghoonghae--tossinvest-cli)

HTML

<a href="/listings/junghoonghae--tossinvest-cli"><img src="/api/listings/junghoonghae--tossinvest-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 266 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://tossinvest-cli.vercel.app/"><img src="docs/assets/hero-banner-v5.png" alt="tossinvest-cli — AI 에이전트와 터미널에서 토스증권 사용하기" width="100%" /></a>
  3. </p>
  4. <p align="right"><strong>한국어</strong> · <a href="README.en.md">English</a></p>
  5. <h1 align="center">tossinvest-cli</h1>
  6. <p align="center">
  7. <strong>공식 API에 없는 투자 정보까지, 내 AI에게.</strong>
  8. <br />종목 탐색부터 자산·손익·세금·관심종목 관리까지, <code>tossctl</code> 하나로.
  9. </p>
  10. <p align="center">
  11. <a href="https://github.com/JungHoonGhae/tossinvest-cli/actions/workflows/ci.yml"><img src="https://github.com/JungHoonGhae/tossinvest-cli/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
  12. <a href="https://github.com/JungHoonGhae/tossinvest-cli/releases"><img src="https://img.shields.io/github/v/release/JungHoonGhae/tossinvest-cli" alt="Latest release" /></a>
  13. <a href="LICENSE"><img src="https://img.shields.io/github/license/JungHoonGhae/tossinvest-cli" alt="MIT License" /></a>
  14. </p>
  15. <p align="center">
  16. <a href="#빠른-시작"><strong>빠른 시작</strong></a> ·
  17. <a href="#공식-api에-없는-기능까지-tossctl로"><strong>더 할 수 있는 일</strong></a> ·
  18. <a href="#ai와-함께-사용하기"><strong>AI 연결</strong></a> ·
  19. <a href="#주문-전-확인하세요"><strong>주문 전 확인</strong></a> ·
  20. <a href="https://tossinvest-cli.vercel.app/docs"><strong>문서</strong></a>
  21. </p>
  22. > [!WARNING]
  23. > 이 프로젝트는 토스증권 공식 제품이 아닙니다. 공식 Open API 외 기능은 토스증권 웹 내부 API를 비공식적으로 사용하며, 이용약관 위반에 해당할 수 있고 예고 없이 변경될 수 있습니다. 계좌 제한·손실 등 사용 결과는 사용자 본인의 책임입니다.
  24. ## 공식 API에 없는 기능까지, tossctl로
  25. tossctl은 [공식 API에 없는 **30가지 이상의 기능**](https://tossinvest-cli.vercel.app/docs/reference/support-scope)을 내 AI와 자동화에 연결합니다. 종목을 찾는 일부터 내 자산의 변화와 세금 자료를 확인하는 일까지 한곳에서 다루세요.
  26. <p align="center">
  27. <img src="diagrams/readme-features.png" alt="공식 API의 시세·계좌·보유종목 조회에 더해, tossctl이 공식 API에 없는 30+ 기능을 터미널과 AI 앱에 연결합니다. 종목 분석, 뉴스·일정, 자산·성과, 세금·수익, 투자 관리의 다섯 영역을 함께 활용합니다." width="100%" />
  28. </p>
  29. <details>
  30. <summary>기능별 비교 보기</summary>
  31. | 더 할 수 있는 일 | 공식 Open API | tossctl에서 연결하는 기능 |
  32. |---|:---:|---|
  33. | 종목 발굴·분석 | 미지원 | 토스 AI 시그널·등락 이유·조건검색·업종별 분석 |
  34. | 뉴스·투자 일정 확인 | 미지원 | 보유·관심종목 뉴스·어닝콜·주요 경제지표 일정 |
  35. | 내 자산·성과 모아 보기 | 미지원 | 전체 계좌 합산·평가 이력·배당·기간별 실현손익 |
  36. | 세금·추가 수익 확인 | 미지원 | 해외 양도소득·예탁금 이자·주식대여 예상 수익 |
  37. | 내 투자 관리 | 미지원 | 관심종목 폴더·목표가 알림·숨긴 종목·주식모으기 조회 |
  38. </details>
  39. **“잔고가 얼마야?”에서 “내 자산 변화와 받은 배당, 보유 종목 뉴스까지 정리해 줘”로.** 앱에서 따로 확인하던 정보를 이제 내 AI에게 요청하세요.
  40. 위 추가 기능은 WTS(토스증권 웹 내부 API)를 사용합니다. 지원 대상은 **토스증권**이며, 일반 토스뱅킹·카드 소비 내역은 포함하지 않습니다. [전체 기능 비교 →](https://tossinvest-cli.vercel.app/docs/reference/support-scope)
  41. ## 빠른 시작
  42. macOS / Linux:
  43. ```bash
  44. curl -fsSL https://raw.githubusercontent.com/JungHoonGhae/tossinvest-cli/main/install.sh | sh
  45. tossctl auth login --phone
  46. tossctl account summary --output json
  47. ```
  48. <p align="center">
  49. <img src="diagrams/readme-workflow.png" alt="휴대폰으로 로그인하고 시세·수급·계좌·배당을 선택해 CLI나 MCP로 조회합니다. 결과는 터미널·JSON·AI 답변으로 활용하며, 실주문은 별도 미리보기와 사람의 승인이 필요합니다." width="100%" />
  50. </p>
  51. 이름·생년월일·휴대폰 번호를 입력하면 토스 앱으로 승인 알림이 갑니다. 알림을 승인한 뒤 **이 기기 로그인 유지**까지 승인하세요. 입력한 정보는 토스증권 로그인 화면에만 전달하고 저장하지 않습니다. 브라우저 QR 로그인은 `tossctl auth login`, 링크는 `tossctl auth login --link`입니다.
  52. <details>
  53. <summary>Windows · Homebrew · 공식 API 연결</summary>
  54. Windows PowerShell에서 설치한 뒤 위의 로그인·조회 명령을 실행하세요.
  55. ```powershell
  56. irm https://raw.githubusercontent.com/JungHoonGhae/tossinvest-cli/main/install.ps1 | iex
  57. ```
  58. 공식 Open API 키를 연결하려면(웹 로그인 후):
  59. ```bash
  60. tossctl openapi setup # 기존 키 연결 · 저장해 둔 Secret 입력 · 새 키 발급 중 안내
  61. tossctl openapi status
  62. ```
  63. 키와 Secret을 이미 갖고 있다면 `tossctl openapi login`으로 직접 등록할 수도 있습니다.
  64. Homebrew·소스 빌드는 [설치 문서](https://tossinvest-cli.vercel.app/docs/getting-started/installation), 인증·연결 문제는 `tossctl doctor --report`를 참고하세요.
  65. </details>
  66. <details>
  67. <summary>설치부터 첫 조회까지 — 데모</summary>
  68. <p align="center">
  69. <img src="docs/assets/demo/install.gif" alt="tossctl 설치와 로그인 후 첫 계좌 조회" width="760" />
  70. </p>
  71. </details>
  72. ## 이렇게 사용하세요
  73. ```bash
  74. # 시장 살펴보기
  75. tossctl quote flows A005930
  76. tossctl market signals
  77. # 내 배당 확인하기
  78. tossctl portfolio dividends
  79. # 이번 달 이전의 완료·취소 주문도 확인하기
  80. tossctl orders completed --all-dates --size 50
  81. # 보유 종목을 스크립트로 넘기기
  82. tossctl portfolio positions --output json
  83. ```
  84. 위 수급 명령은 WTS를 사용하며, 공식 API의 투자자별 매매동향 조회도 별도로 지원합니다. AI 시그널·배당 등 추가 기능의 사용법은 [명령 레퍼런스](https://tossinvest-cli.vercel.app/docs/reference/commands)에서 확인하세요.
  85. <details>
  86. <summary>실시간 구독 · API 감시 · 로컬 이력</summary>
  87. ```bash
  88. # 전체 계좌 자산과 보유 종목 브리핑
  89. tossctl account overview
  90. tossctl portfolio briefing
  91. # 실시간 체결 구독과 API 변경 감시
  92. tossctl stream --trade A005930
  93. tossctl monitor api # 읽기 전용 점검; 통과 0, 실패 1
  94. ```
  95. `tossctl history sync`로 보유 종목·거래 내역 수집을 미리 확인할 수 있습니다. 저장 후 `history list`, `history search`, `history compare`는 오프라인으로 동작합니다.
  96. `--fields symbol,quantity --compact`로 필요한 JSON 필드만 받으세요. [로컬 이력·브리핑 가이드 →](https://tossinvest-cli.vercel.app/docs/guide/history)
  97. </details>
  98. ## AI와 함께 사용하기
  99. <p align="center">
  100. <img src="diagrams/readme-overview.png" alt="터미널·스크립트의 CLI와 AI 에이전트의 MCP가 하나의 tossctl로 공식 Open API와 WTS 내부 API에 연결됩니다. 공식 키가 있으면 지원 조회는 기본적으로 공식 API를 우선 사용하고, WTS 전용 기능은 웹 세션을 사용합니다." width="100%" />
  101. </p>
  102. **설치한 tossctl을 AI 앱에 연결하면 말로 요청할 수 있습니다.** Claude Code·Codex·Cursor에서 MCP 연결을 지원합니다.
  103. Claude Code에 MCP를 등록하려면:
  104. ```bash
  105. claude mcp add tossctl tossctl mcp
  106. ```
  107. 연결한 에이전트에 이렇게 요청하세요.
  108. > 내 자산 변화와 받은 배당을 정리하고, 보유 종목 뉴스도 함께 보여줘.
  109. Codex·Cursor 등 앱별 등록 방법은 [MCP 가이드](https://tossinvest-cli.vercel.app/docs/guide/mcp)를 참고하세요.
  110. **(선택) 에이전트 스킬.** 스킬을 지원하는 에이전트(Claude Code 등)라면, 오퍼레이션 탐색·인증·안전 규칙(읽기 우선·거래 게이트·실계좌 데이터 비노출)을 담은 `tossctl` 스킬을 설치하면 더 정확하게 동작합니다. CLI가 이미 있으면 바이너리에 내장된 스킬을 바로 설치할 수 있고(오프라인·버전 일치), 없으면 curl 한 줄로도 됩니다. 설치·동기화는 [`skills/`](skills/) 참고:
  111. ```sh
  112. tossctl skill install # CLI 내장본 설치
  113. curl -fsSL https://raw.githubusercontent.com/JungHoonGhae/tossinvest-cli/main/skills/install.sh | sh # CLI 없이
  114. ```
  115. <details>
  116. <summary>다른 AI 앱에 연결하기 — MCP 설정</summary>
  117. 사용하는 AI 앱이 아래 형식의 MCP 설정을 지원하면 추가하세요.
  118. ```json
  119. {
  120. "mcpServers": {
  121. "tossinvest": { "command": "tossctl", "args": ["mcp"] }
  122. }
  123. }
  124. ```
  125. </details>
  126. <details>
  127. <summary>AI 에이전트에 MCP 연결 — 데모</summary>
  128. <p align="center">
  129. <img src="docs/assets/demo/mcp.gif" alt="tossctl MCP 서버를 AI 에이전트에 연결" width="760" />
  130. </p>
  131. </details>
  132. ## 주문 전 확인하세요
  133. > [!IMPORTANT]
  134. > **실거래는 기본적으로 꺼져 있습니다.** 에이전트는 주문을 미리보기합니다. 실제 주문은 사람이 검토·승인하고 실행하세요.
  135. ```bash
  136. tossctl order preview --symbol AAPL --side buy --qty 1 --price 200
  137. # 미리보기만 실행합니다. 실제 주문은 사람이 결과와 확인 토큰을 검토한 뒤 진행하세요.
  138. ```
  139. - **주문 내용 확인:** 종목·수량·가격을 미리보기에서 확인한 뒤 직접 승인하고 실행하세요.
  140. - **관심종목·알림 변경:** 무엇이 바뀌는지 미리 확인하고 승인하세요.
  141. - **전송 결과를 모를 때:** 다시 주문하기 전에 주문 상태부터 확인하세요.
  142. <details>
  143. <summary>미국 옵션 모의투자 — 실험 기능</summary>
  144. 아직 안정화 중이며 기본적으로 숨겨져 있습니다. 활성화해도 토스증권의 이용 자격을 별도로 충족해야 합니다. 모의투자와 실거래의 잔고·주문은 분리되고, 모의 주문 승인이 실거래 승인으로 이어지지 않습니다. 설정과 제한은 [지원 범위](https://tossinvest-cli.vercel.app/docs/reference/support-scope)에서 확인하세요.
  145. </details>
  146. 거래를 활성화하는 방법과 확인 절차는 [안전 가이드](https://tossinvest-cli.vercel.app/docs/guide/safety)를 참고하세요.
  147. ## 문서
  148. | 문서 | 내용 |
  149. |---|---|
  150. | [빠른 시작](https://tossinvest-cli.vercel.app/docs/getting-started/quickstart) | 설치 후 첫 조회까지 |
  151. | [명령 레퍼런스](https://tossinvest-cli.vercel.app/docs/reference/commands) | 전체 CLI 명령과 예시 |
  152. | [지원 범위](https://tossinvest-cli.vercel.app/docs/reference/support-scope) | 공식 API·WTS 기능 비교 |
  153. | [AI 앱 연결](https://tossinvest-cli.vercel.app/docs/guide/mcp) | Claude Code·Codex·Cursor 설정 |
  154. | [안전 가이드](https://tossinvest-cli.vercel.app/docs/guide/safety) | 실제 주문 전 설정과 확인 절차 |
  155. 문제나 제안은 [Issues](https://github.com/JungHoonGhae/tossinvest-cli/issues)에 남겨주세요. 보안 문제는 [`SECURITY.md`](SECURITY.md)를 참고하세요.
  156. ## 스폰서십 · 후원
  157. <p align="center">
  158. <a href="mailto:support@remodule.dev?subject=tossinvest-cli%20sponsorship"><img src="diagrams/readme-sponsor.png" alt="스폰서 모집 — 이 자리에 브랜드를 소개하세요. 스폰서십 문의: support@remodule.dev" width="100%" /></a>
  159. </p>
  160. 스폰서십·브랜드 노출에 관심이 있다면 [support@remodule.dev](mailto:support@remodule.dev?subject=tossinvest-cli%20sponsorship)로 연락해 주세요.
  161. <p align="center">
  162. <a href="https://github.com/sponsors/JungHoonGhae"><img src="docs/assets/badges/sponsor.svg" height="46" alt="Become a sponsor" /></a>
  163. </p>
  164. <!-- sponsors:start -->
  165. <p align="center">
  166. <a href="https://github.com/sponsors/JungHoonGhae" title="비공개 후원자 / private sponsor"><img src="docs/assets/sponsors/anonymous.svg" width="56" height="56" alt="private sponsor" /></a>
  167. </p>
  168. <p align="center"><sub>현재 <strong>1</strong>분이 제 오픈소스 작업을 후원하고 있습니다 (일회성 포함). 후원은 tossinvest-cli를 포함한 제 작업 전반에 쓰입니다.</sub></p>
  169. <!-- sponsors:end -->
  170. ## Contributors
  171. 기여해 주신 모든 분께 감사합니다. 참여 방법은 [`CONTRIBUTING.md`](CONTRIBUTING.md)를 참고하세요.
  172. [![tossinvest-cli contributors](https://contrib.rocks/image?repo=JungHoonGhae/tossinvest-cli)](https://github.com/JungHoonGhae/tossinvest-cli/graphs/contributors)
  173. ## Star History
  174. <!-- star-history:start -->
  175. <picture>
  176. <source media="(prefers-color-scheme: dark)" srcset="docs/assets/star-history/star-history-v2-dark.svg">
  177. <img alt="Star history" src="docs/assets/star-history/star-history-v2-light.svg">
  178. </picture>
  179. <!-- star-history:end -->
  180. ## License
  181. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.