# Show GN: Cluefin-Dure - 증권사/DART API를 활용한 국내주식 멀티 AI 에이전트

> Clean Markdown view of GeekNews topic #27701. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=27701](https://news.hada.io/topic?id=27701)
- GeekNews Markdown: [https://news.hada.io/topic/27701.md](https://news.hada.io/topic/27701.md)
- Type: show
- Author: [kgcrom](https://news.hada.io/@kgcrom)
- Published: 2026-03-21T14:20:16+09:00
- Updated: 2026-03-21T14:20:16+09:00
- Original source: [github.com/kgcrom](https://github.com/kgcrom/cluefin-dure)
- Points: 2
- Comments: 0

## Topic Body

안녕하세요.  
  
6개월 전에 [cluefin](https://news.hada.io/topic?id=22951) 프로젝트를 공유했었는데요,  
이번에는 cluefin에 만든 openapi 패키지(증권사, DART RestAPI)를   
AI 에이전트가 사용할 수 있는 도구로 연결해서 투자 리서치 멀티 에이전트 프로젝트 "[cluefin-dure](https://github.com/kgcrom/cluefin-dure)"를 만들었습니다.  
  
그동안 cluefin으로 CLI, TUI, 프론트도 만들어보고 AI 연동 해보고, 자동 매매/백테스팅도 이것저것 만져봤습니다.  
만드는 과정이 재밌기는 했지만 꾸준히 사용하지 못했고 그러다보니 개선할게 없고.. 그저 불필요한 기능 추가...악순환;;  
  
그러다가 [Dexter](https://github.com/virattt/dexter) 프로젝트를 보고 "오!! 이걸 내 필요에 맞게 만들면 쓸만하겠다" 싶어서 시작했습니다.  
  
갓 virattt!!!  
  
네, 지금까지 한풀이였고요, 프로젝트 소개하겠습니다.  
  
---  
### 목표  
과거 농번기에 사람들이 힘을 모아 농사일하듯,  
나의 투자도 AI 에이전트들이 역할을 나눠 같이 봐주면 좋겠다는 생각으로  
이름을 "두레"라고 붙였습니다.  
  
아직 다듬을 부분은 많지만, 단순히 종목 하나 물어보는 걸 넘어서  
리서치, 기업 분석, 포트폴리오 관리까지 하나의 워크플로우로 묶은 투자 비서 같은 도구를 만드는 게 목표입니다.  
  
### 주요 기능들  
  
[pi](https://pi.dev)를 이용했습니다. 🙏🏼  
  
#### 🤖 멀티 에이전트 리서치  
펀더멘털 / 뉴스 / 전략 / 백테스트 / 비평 역할을 나눠 리서치를 진행합니다.  
  
#### 💬 대화형 탐색  
터미널에서 자연어로 바로 기업 분석을 시도할 수 있습니다.  
  
#### 📊 시나리오 분석  
예를 들어 `연준이 50bp 긴급 인하하면 반도체 섹터 어떻게 되나?`  
같은 질문을 던지면 시나리오를 구조화해서 종목별 영향과 종합 평가를 리포트로 정리합니다.  
  
#### 🔎 종목 스크리닝  
시장/스타일 기준으로 후보 종목을 추리고 우선순위를 볼 수 있습니다.  
  
#### 🧪 전략 리서치 + 백테스트  
전략 아이디어를 넣으면 전략 설계, 백테스트, 비평까지 이어서 볼 수 있습니다.  
  
#### 📝 결과 저장과 리포트  
실행 결과는 data/runs/<runId>/report.html 형태로 남고, 터미널 요약과 HTML 리포트로 함께 볼 수 있습니다.  
  
#### 🧠 메모리 축적  
전략, 실험, 논제 같은 내용을 파일 기반 메모리로 조금씩 쌓는 구조도 넣고 있습니다.  
아직 초기 단계지만, 쓸수록 더 나아지고 개인 선호도를 반영되게 만들고 싶습니다.  
  
.  
앞으로 계획  
- 한국투자증권 미국 주식 tool 추가  
- EDGAR API tool 추가  
- xbrl 다운로드 & 파싱 tool 추가  
- 금감원 공시에서 주석 파싱 tool 추가  
- MiroFish 간소화된 버젼으로 하나의 이벤트를 시뮬레이션 해 볼 수 있는 기능 개발  
- autoresearch 개념을 적용해서 더 나은 리서치와 기업 분석 진행하도록 기능 개발  
---  
  
필요한 키는 4개입니다.  
- OpenAI, Google AI 구독 또는 Anthropic API Key  
- [한국투자증권 RestAPI Key](https://apiportal.koreainvestment.com/intro)  
- [키움증권 RestAPI Key](https://openapi.kiwoom.com/main/home)  
- [금융감독원 OpenDart Key](https://opendart.fss.or.kr/)  
  
필요한 키가 많긴 합니다. ㅎㅎ  
구조 자체에 관심 있으시면 코드만 가볍게 훑어보셔도 재미있을 것 같습니다.  
  
감사합니다.

## Comments



_No public comments on this page._