한 줄 요약
Hermes Agent, 오픈소스 주식 분석 시스템, DART·KIS API, 메신저를 연결해 “자동매매”보다 먼저 매일 정해진 형식으로 시장·종목·후보·로그를 보고하는 개인 투자 운영실을 만듭니다.
핵심 주장
목표는 챗봇이 아니라 운영 시스템입니다
정해진 시간에 데이터를 보고, 판단 근거를 남기고, 채널에 결과를 누적합니다. 대화가 아니라 기록이 쌓이는 구조여야 나중에 복기가 됩니다.
처음부터 실거래를 켜지 않습니다
2~4주 이상 조회·모의·알림 모드로 품질을 먼저 검증합니다. 이 기간이 아깝게 느껴진다면, 그건 아직 검증할 지표를 안 정했다는 뜻입니다.
실행 엔진과 분석 로직을 분리합니다
Hermes Agent를 실행·스케줄링·메신저 발송 엔진으로 두고, 분석 로직은 오픈소스 시스템을 참고해 필요한 만큼만 줄여서 적용합니다.
구축 흐름 7단계
- Hermes Agent 설치하고 확인하기
설치 후
hermes --version과hermes doctor로 상태를 확인합니다. - 모델 인증 붙이기 OpenAI API Key 또는 Codex OAuth를 씁니다. ChatGPT Plus·Pro 구독을 쓰고 있다면 Codex OAuth 쪽이 관리하기 편합니다.
- 전용 프로필 만들기
일반 대화용 에이전트와 분리합니다.
- 미션: 기업 분석·시장 오버뷰·오늘의 후보 종목을 매일 요약해 보고
- 원칙: 데이터 근거 우선, 과장 금지, 매수·매도 강요 금지, 리스크 먼저 표시
- 오픈소스 분석 시스템 참고하기
예:
dragon1086/prism-insight. 한국·미국 시장 분석, PDF 리포트, 알림, 대시보드 운영 아이디어를 참고합니다. 통째로 쓰지 말고 필요한 조각만 가져옵니다. - DART·KIS API 붙이기
DART는 공시와 재무 이벤트, KIS는 현재가·체결가·잔고·주문 가능 정보와 모의·실전 주문을 담당합니다.
붙이는 순서를 지키세요현재가 조회 → 잔고 조회 → 모의투자 → 소액 실거래. 이 순서를 건너뛰면 문제가 생겼을 때 원인이 코드인지 판단인지 구분할 수 없습니다.
- 보고 채널 나누기 기업분석 · 시장 오버뷰 · 오늘의 후보 · 거래 로그 · 에이전트 상태로 나눕니다. 봇 권한은 메시지 보내기, 기록 읽기, 파일 첨부, 링크 임베드면 충분합니다.
- 운영 루틴 세우기 아래 스케줄처럼 시각을 고정합니다. 시각이 흔들리면 비교가 안 되고, 비교가 안 되면 복기도 못 합니다.
운영 루틴
| 시각 | 보고 | 목적 |
|---|---|---|
| 08:30 | 시장 오버뷰 | 장 시작 전 판을 본다 |
| 09:10 | 오늘의 후보 | 관찰 대상을 좁힌다 |
| 12:20 | 오전장 중간 점검 | 아침 가정이 깨졌는지 본다 |
| 15:45 | 거래 로그·복기 | 오늘의 판단을 기록으로 남긴다 |
| 주 1회 | 관심 종목 심층 리포트 | 매일 보기에는 무거운 것을 몰아서 본다 |
가져올 만한 패턴
1. 채널을 기능별로 나눕니다
시장 오버뷰 · 종목 분석 · 오늘의 후보 · 거래 로그 · 에이전트 상태. 이 구조는 특정 메신저에 묶이지 않습니다. 텔레그램 토픽, 슬랙 채널, 옵시디언 데일리 노트 섹션으로 그대로 옮길 수 있습니다.
2. 추천 대신 “관찰 후보와 무효 조건”으로 씁니다
좋은 포맷은 이렇습니다.
- 후보 이유
- 진입 조건
- 무효 조건 — 어떤 일이 생기면 이 후보를 버리는가
- 제외 이유
- 리스크 문장
단정하지 않으면서도 의사결정 재료로 남습니다. 무효 조건이 빠진 후보는 나중에 맞았는지 틀렸는지조차 판정할 수 없습니다.
3. 자동주문은 맨 마지막에 둡니다
- 현재가 조회
- 잔고 조회
- 모의투자
- 검증된 소액 실거래
- 자동화 범위 확대
봇 아키텍처와의 접점
5-Layer 봇 아키텍처(Signal Engine · Position Manager · Risk Manager · Monitoring · Manual Interface)와 견주면, 이 가이드는 특히 아래 세 층과 맞물립니다.
| 레이어 | 이 가이드가 채우는 것 |
|---|---|
| Monitoring | 채널별 알림, 에이전트 상태, 중복 방지 |
| Manual Interface | 사람이 읽고 승인·보류를 판단하는 채널 구조 |
| Risk Manager | 실거래 전 모의 모드, 최소 권한, 소액 단계 진입 |
구성 요소를 자기 환경으로 바꿔 읽으면 이렇게 됩니다.
- Hermes ↔ 로컬 에이전트·실행 계층
- Discord ↔ 텔레그램·슬랙·옵시디언 보고 채널
- 분석 코드 ↔ DART·KIS·뉴스 API 파이프라인
- 거래 로그 ↔ 옵시디언·DB 기반 복기 지식베이스
주의점과 리스크
이 문서는 개인 운영 시스템을 만드는 방법을 정리한 것입니다. 종목 추천이나 매매 권유가 아니며, 투자 판단과 그 결과는 본인 책임입니다.
- 여기 적힌 명령은 설치·설정 예시입니다. 실제 실행 전에 별도로 검토하세요.
- KIS·DART API 키와 봇 토큰은 민감 정보입니다.
.env나 시크릿 관리 도구에 두고, 저장소에 올리지 마세요. - “AI가 매일 후보를 뽑는다”는 구조는 과신을 부릅니다. 후보·근거·무효 조건·사후 복기를 반드시 함께 남기세요.
- 실거래 자동화로 넓히려면 증권사 약관, API 호출 제한, 주문 오류 처리, 손절과 일일 손실 한도를 따로 설계해야 합니다.
다음에 할 것
- 이 가이드를 기존 트레이딩 봇 프로젝트 문맥과 합칠지 정하기
- 지금 쓰는 채널 구조에서 어떤 전달 경로가 맞는지 정하기
- “시장 오버뷰 1개 + 후보 종목 1개” 스케줄만으로 최소 버전 설계하기
- KIS·DART를 실거래 권한 없이 조회 전용으로 먼저 붙이는 설계안 쓰기