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

안녕하세요.

6개월 전에 cluefin 프로젝트를 공유했었는데요,
이번에는 cluefin에 만든 openapi 패키지(증권사, DART RestAPI)를
AI 에이전트가 사용할 수 있는 도구로 연결해서 투자 리서치 멀티 에이전트 프로젝트 "cluefin-dure"를 만들었습니다.

그동안 cluefin으로 CLI, TUI, 프론트도 만들어보고 AI 연동 해보고, 자동 매매/백테스팅도 이것저것 만져봤습니다.
만드는 과정이 재밌기는 했지만 꾸준히 사용하지 못했고 그러다보니 개선할게 없고.. 그저 불필요한 기능 추가...악순환;;

그러다가 Dexter 프로젝트를 보고 "오!! 이걸 내 필요에 맞게 만들면 쓸만하겠다" 싶어서 시작했습니다.

갓 virattt!!!

네, 지금까지 한풀이였고요, 프로젝트 소개하겠습니다.

목표

과거 농번기에 사람들이 힘을 모아 농사일하듯,
나의 투자도 AI 에이전트들이 역할을 나눠 같이 봐주면 좋겠다는 생각으로
이름을 "두레"라고 붙였습니다.

아직 다듬을 부분은 많지만, 단순히 종목 하나 물어보는 걸 넘어서
리서치, 기업 분석, 포트폴리오 관리까지 하나의 워크플로우로 묶은 투자 비서 같은 도구를 만드는 게 목표입니다.

주요 기능들

pi를 이용했습니다. 🙏🏼

🤖 멀티 에이전트 리서치

펀더멘털 / 뉴스 / 전략 / 백테스트 / 비평 역할을 나눠 리서치를 진행합니다.

💬 대화형 탐색

터미널에서 자연어로 바로 기업 분석을 시도할 수 있습니다.

📊 시나리오 분석

예를 들어 연준이 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
• 키움증권 RestAPI Key
• 금융감독원 OpenDart Key

필요한 키가 많긴 합니다. ㅎㅎ
구조 자체에 관심 있으시면 코드만 가볍게 훑어보셔도 재미있을 것 같습니다.

감사합니다.