Hermes Agent를 실행 엔진으로 쓰고, 오픈소스 주식 분석 시스템을 참고해 기업 분석·시장 오버뷰·오늘의 후보 종목을 자동으로 정리하는 방법론입니다. 핵심은 “AI에게 물어보는 챗봇”이 아니라, 정해진 시간에 데이터를 보고 판단 근거를 남기는 운영 시스템을 만드는 것입니다.
주식 데이터를 모으고, 에이전트가 분석하고, Discord 채널에 요약·근거·주의사항을 발송합니다.
Hermes는 명령 실행과 스케줄링, 분석 코드는 시장 데이터와 리포트 생성, Discord는 결과 공유 공간을 담당합니다.
처음부터 실제 주문을 켜지 말고, 2~4주 동안 모의·조회·알림만 운영하면서 품질을 검증합니다.
아래 순서대로 진행하면 “설치 → 모델 인증 → 전용 프로필 → 분석 시스템 적용 → API 커스터마이징 → Discord 발송 → 운영 루틴”까지 이어집니다.
Hermes Agent는 터미널에서 파일을 읽고, 코드를 실행하고, 스케줄 작업을 만들고, Discord 같은 메신저로 결과를 보내는 에이전트 실행 환경입니다.
# macOS / Linux / WSL 권장
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 설치 확인
hermes --version
hermes doctorhermes doctor 결과를 먼저 확인합니다.API 키를 직접 넣는 방식도 가능하지만, ChatGPT Plus/Pro 구독을 쓰는 경우 Codex OAuth 방식이 관리하기 쉽습니다. Hermes에서 OpenAI Codex provider로 로그인한 뒤 모델을 선택합니다.
# 대화형 모델 설정 메뉴
hermes model
# 또는 OAuth 로그인
hermes login --provider openai-codex
# 정상 동작 테스트
hermes chat -Q -q "내 주식 분석 비서 설정을 시작할 준비가 되었는지 3줄로 답해줘."| 선택지 | 언제 쓰나 |
|---|---|
| OpenAI API Key | 사용량 기반 과금, 서버 자동화에 안정적 |
| Codex OAuth | 구독 기반 계정을 활용하고 싶을 때 편리 |
| OpenRouter/Anthropic 등 | 분석·요약 모델을 분리하고 싶을 때 |
주식 비서는 일반 대화용 에이전트와 분리해야 합니다. 프로필을 나누면 설정, 기억, 스케줄, Discord 연결을 독립적으로 관리할 수 있습니다.
# 기존 프로필 확인
hermes profile list
# 전용 프로필 생성: 이름은 예시입니다
hermes profile create trading-assistant --clone --clone-from default
# 프로필 확인
hermes profile show trading-assistant
# 전용 프로필로 테스트
hermes --profile trading-assistant chat -Q -q "너는 개인 주식 트레이딩 비서야. 역할을 5줄로 정리해줘."프로필 설명 파일에는 아래처럼 미션을 짧게 넣습니다.
역할: 개인 주식 트레이딩 리서치 비서
목표: 기업 분석, 시장 오버뷰, 오늘의 후보 종목을 매일 Discord에 요약
원칙: 데이터 근거 우선, 과장 금지, 매수/매도 강요 금지, 리스크 먼저 표시
운영: 실제 주문 전에는 조회/모의/알림 모드로만 운영처음부터 모든 분석 로직을 새로 만들 필요는 없습니다. prism-insight 같은 공개 저장소는 이미 검증된 구조를 참고할 수 있게 해줍니다.
# 저장소 가져오기
git clone https://github.com/dragon1086/prism-insight.git
cd prism-insight
# 설정 파일 준비
cp mcp_agent.config.yaml.example mcp_agent.config.yaml
cp mcp_agent.secrets.yaml.example mcp_agent.secrets.yaml
cp .env.example .env
# 먼저 Telegram/실거래 없이 분석만 테스트
python stock_analysis_orchestrator.py --mode morning --no-telegram개인 트레이딩 비서의 품질은 데이터 연결에서 갈립니다. DART는 기업 공시·재무 이벤트를, KIS는 실시간 시세·잔고·주문 가능 정보를 담당하게 두면 역할이 명확합니다.
| API | 용도 | 권장 시작 범위 |
|---|---|---|
| DART Open API | 사업보고서, 분기보고서, 주요 공시, 증자/CB/BW 등 이벤트 확인 | 관심 종목의 최근 공시 요약부터 |
| KIS API | 국내/해외 주식 현재가, 체결가, 잔고, 주문 가능 금액, 모의/실전 주문 | 실시간 주식 거래가 조회와 모의투자부터 |
| 뉴스/검색 API | 이슈, 산업 변화, 실적 발표 맥락 수집 | Perplexity/Firecrawl 같은 검색·크롤링 도구 |
예시 환경변수 템플릿:
# .env 또는 프로필 전용 환경파일에 저장
DART_API_KEY=your_dart_key
KIS_APP_KEY=your_kis_app_key
KIS_APP_SECRET=your_kis_app_secret
KIS_ACCOUNT_NUMBER=12345678-01
KIS_ACCOUNT_CODE=01
KIS_MODE=paper # paper 먼저, 검증 후 real
TRADING_DEFAULT_UNIT_KRW=10000
ENABLE_REAL_ORDER=falseDiscord는 투자 비서의 결과를 쌓아두는 “운영 보드”입니다. 채널을 업무별로 나누면 나중에 성과를 복기하기 쉽습니다.
#기업분석, #시장-오버뷰, #오늘의-후보, #거래-로그, #에이전트-상태를 만듭니다.# 전용 프로필에서 게이트웨이 설정
hermes --profile trading-assistant gateway setup
# Discord 연결 상태 확인
hermes --profile trading-assistant gateway status
# 게이트웨이 실행/서비스화
hermes --profile trading-assistant gateway run
# 장기 운영 시
hermes --profile trading-assistant gateway install
hermes --profile trading-assistant gateway start채널 ID를 확인한 뒤 스케줄 발송을 만들 수 있습니다. Discord에서 개발자 모드를 켠 후 채널 우클릭 → ID 복사를 사용합니다.
# 매일 오전 8시 30분 시장 오버뷰 발송 예시
hermes --profile trading-assistant cron create \
--name daily-market-overview \
--deliver discord:YOUR_MARKET_OVERVIEW_CHANNEL_ID \
"30 8 * * 1-5" \
"오늘 장 시작 전 시장 오버뷰를 작성해줘. 지수, 환율, 금리, 섹터 흐름, 리스크를 700자 이내로 정리하고 투자 조언이 아니라 참고 정보라고 명시해."처음에는 “많이 보내기”보다 “매일 같은 형식으로 보내기”가 중요합니다. 아래 템플릿을 그대로 쓰면 제3자도 결과를 읽고 판단하기 쉽습니다.
지수·환율·금리·전일 미국장·섹터 강약·오늘 체크할 리스크를 요약합니다.
기술적 흐름, 수급, 재무, 사업모델, 뉴스, 공시를 한 종목당 한 메시지로 정리합니다.
추천을 단정하지 않고, 관찰 후보·진입 조건·무효 조건을 분리합니다.
| 시간 | 채널 | 내용 |
|---|---|---|
| 08:30 | #시장-오버뷰 | 전일 글로벌 시장, 국내 장전 변수, 오늘의 리스크 |
| 09:10 | #오늘의-후보 | 장 초반 거래대금/거래량 기반 관찰 후보 |
| 12:20 | #시장-오버뷰 | 오전장 중간 점검, 강한 섹터와 약한 섹터 |
| 15:45 | #거래-로그 | 오늘 신호 복기, 진입 조건 충족/불충족, 내일 체크할 것 |
| 주 1회 | #기업분석 | 관심 종목 5~10개 심층 리포트 |
복잡해 보이지만 역할은 단순합니다. 데이터는 API에서, 판단은 에이전트에서, 결과는 Discord에서, 복기는 로그에서 합니다.
trading-assistant/
├─ prism-insight/ # 참고/커스터마이징 코드
├─ configs/
│ ├─ .env # API 키: 절대 공유 금지
│ ├─ prompts/ # 채널별 프롬프트
│ └─ watchlist.csv # 관심 종목
├─ outputs/
│ ├─ reports/ # 기업 분석 markdown/pdf
│ └─ logs/ # 매일 실행 로그
└─ scripts/
├─ run_market_overview.py
├─ run_company_report.py
└─ send_discord_summary.py아래 항목을 모두 체크하면 최소 운영 버전이 완성됩니다.
hermes doctor 통과trading-assistant 같은 전용 profile 생성--no-telegram 테스트 완료