My Stock Buddy

Chat Agent

자연어로 예수금·잔고·시세·뉴스·거래량 순위·코스피 지수 등을 조회하고, 업비트·코인원 가상자산 시세·잔고·주문(회원 API 키 등록 시)도 Agent에서 지원합니다. 탐색 도구로 데이터를 분석할 수 있으며, 포트폴리오 재구성 추천 시 보수/균형/공격 옵션을 선택할 수 있습니다.

포트폴리오 재구성

최근 업종·시장 시황과 뉴스를 반영해 보유 종목 매도 후 새 포트폴리오를 추천합니다. 옵션 1(보수적)·옵션 2(균형)·옵션 3(공격적) 중 선택하면 구체적인 종목·비중과 주문 지원을 받을 수 있습니다.

실제 거래 (주문 실행)

Agent가 매수·매도 주문을 제안하면 주문 확인 (MCP Elicitation) 대화상자가 표시됩니다. 종목코드·매수/매도·수량·가격을 확인하거나 수정한 뒤 실행 버튼으로 주문을 넣을 수 있습니다. 국내 주식은 LS증권·한국투자증권 API로, 가상자산은 업비트·코인원 API(회원 키 등록 시)로 처리됩니다.

자동 운용 (스케줄)

서버가 설정한 주기마다 회원별로 이 Chat Agent와 동일한 LLM·MCP·도구 경로로 한 턴 실행합니다. 주식만 연동된 경우 거래일 장중 위주로 실행되고, 업비트·코인원 API 키가 있으면 장외에도 틱이 돌며 가상자산 점검·LIVE 주문이 포함될 수 있습니다(키 없을 때 장외 스킵·도구 제한 등은 docs/auto-trade.md 참고). 브라우저를 닫아도 서버에서만 동작합니다. Agent 화면에서는 「자동 운용 켜기」「자동 운용 중지」 칩과 상단 배너로 제어하며, 중지는 UI 또는 POST /api/member/auto-trade 로 enabled: false 를 보내면 됩니다. 구 「자동 운용 안내」 칩에 있던 설명은 이 절로 옮겼습니다.

• 거래 모드 — OBSERVE: 분석·요약 위주(실제 주문 없음). LIVE: 설정 한도·허용 증권사·사전 동의 범위 안에서 실제 매매가 나갈 수 있음.
• 운영모드 (operationStyle) — OBSERVE/LIVE와 별개로, 스케줄마다 LLM에 붙는 성향 지시입니다. Agent 화면 「운영모드」 칩 또는 POST {"operationStyle":"BALANCED"} 등으로 변경합니다. GET /api/member/auto-trade 응답의 operationStyle·operationStyleLabelKo·operationStyles로 현재 값과 선택지를 확인할 수 있습니다.

  코드	한글	전략 요지
  CONSERVATIVE	보수적	진입 신중·다중 근거, +1% 이상 익절 우선, 손절 금지, 추격·과회전 억제
  BALANCED	균형	단기·스윙 균형(기본), +1% 이상 익절, 손절 금지, 과매매 억제
  AGGRESSIVE	공격적	모멘텀·거래대금 활용 진입 적극화(한도·분할 필수), 급변 시 방어 전환
  OPPORTUNISTIC	기회추구	단기 변동·뉴스·스프레드 기회, 짧은 보유·회전(수수료 감안)
  DEFENSIVE	자본방어	현금·방어, 신규 최소·정리·축소 우선, 약세·고변동 시 관망

  각 스케줄 턴의 채팅 사용자 메시지에는 운영:균형(BALANCED) 형태로도 표시됩니다. 상단 배너에도 현재 운영모드가 보입니다.
• 설정·조회 — GET/POST /api/member/auto-trade (로그인 세션). 거래 모드·운영모드·주기·회차당 한도·허용 브로커·다음 실행 시각·최근 로그·usageSummary 등을 조회·변경합니다.
• 채팅·폴링 — 자동 운용이 켜져 있으면 Agent 화면이 GET /api/member/chat-history/recent?after=…&source=agent 로 주기적으로 조회해 새 메시지를 채팅에 반영합니다. 스케줄 턴마다 수동 채팅과 같은 형식(phase·도구 타임라인 포함 가능)으로 이력에 저장됩니다.

수익을 보장하지 않습니다. LIVE는 실제 주문이 발생할 수 있으므로 한도·브로커·동의를 반드시 확인하세요. 장·자산별 스킵·도구 allowlist·사전 스냅샷 등 상세는 저장소 문서 docs/auto-trade.md 를 참고하세요.

BI 탐색 도구

일봉·테마별 데이터를 CSV로 불러와 피벗·캔들·라인 차트로 시각화합니다. 종목별 주가와 해당 일자의 뉴스·공시 제목을 한 화면에서 연계해 볼 수 있습니다.

• getStockDailyForAnalysis — 단일 종목 최근 일봉 CSV → 분석 도구 등록 후 링크 반환
• getThemeDailyCloseForAnalysis — 지난 주 테마별 종가 CSV → 분석 도구
• getThemeMinutePricesForAnalysis — 테마별 5분봉 CSV → 분석 도구
• getStockPatternAnalysisForAnalysis — 패턴·기술지표(RSI·MACD·볼린저) CSV → 분석 도구 차트 시각화
• registerDataForAnalysis — CSV/JSON 등록 후 분석 링크 반환

종목 추천·매수/매도 판단 시 활용하는 분석 도구

Agent는 종목 추천, 매수/매도 타이밍, 보유 종목 검토 시 아래 MCP 도구를 활용해 분석합니다. 모든 추천·판단 응답에서 종목별 사유 3가지 이상과 어떤 분석 결과를 근거로 했는지를 명시합니다.

시장·레짐

• getRegimeState — 지수/업종의 추세·횡보·변동성 분류(TREND_UP/DOWN, SIDEWAYS, HIGH_VOLATILITY)

종합 점수·펀더멘털

• getMultiFactorScore — 수급·이벤트 리스크·펀더멘털·기술 지표 가중 합산 0~100 (매수 추천·종목 필터링)
• getFundamentalValuationScore — PER·PBR·ROE·부채비율 기반 0~100 (저평가 판단)
• getFinancialRatio — PER, PBR, ROE 등 재무비율

리스크·수급

• getEventRiskScore — 뉴스·공시 키워드 기반 이벤트 리스크 0~100 (높을수록 리스크)
• getFlowCompositeScore — 외인·기관·프로그램 수급 종합 0~100

상대 강도·기술 지표

• getRelativeStrength — 지수(코스피/코스닥) 대비 N일 수익률·베타 (시장 대비 강세/약세)
• getExtendedIndicatorsReport — 스토캐스틱·ATR·ADX·OBV·A/D Line·Williams %R·CCI
• getStockPatternAnalysis — RSI·MACD·볼린저 밴드·이동평균·캔들 패턴

차트·패턴

• detectChartPatterns — 머리어깨형·역머리어깨형·쌍바닥형·쌍봉형 등 고전 패턴 탐지
• getPriceVolumeDivergence — 가격-거래량 다이버전스 점수(-1~1), 상승/하락 다이버전스 반등·조정 가능성

순위·테마·뉴스

• getPriceChangeRank·getVolumeRank·getDividendRank — 등락률·거래량·배당률 순위
• getThematicStocks — AI·반도체·2차전지·바이오 등 테마별 종목
• getStockNews·getRealtimeNewsTitles — 종목 뉴스·시황·실시간 뉴스

내부 시각화 (채팅 링크)

• /analyze/rebalance — 포트폴리오 재구성 보드(교체/유지/제외·비중·사유)
• /analyze/risk — 리스크 히트맵(종목·섹터 위험 점수)
• /analyze/signals — 신호 타임라인(패턴·수급·이벤트 신호 이력)
• /analyze/regime — 레짐 대시보드(추세/횡보/변동성)

DART (DART_API_KEY 설정 시)

• getDartCompanyInfo·searchDartDisclosure·getDartFinancialStatements — 기업 개황·공시 검색·재무제표

사유 작성 예: "멀티팩터 72점(수급·펀더멘털 우수)", "펀더멘털 저평가(PER 12배)", "이벤트 리스크 30점 낮음", "지수 대비 상대강도 +3%p", "스토캐스틱 과매도 구간에서 반등 가능성", "역머리어깨형 상향 돌파" 등.

칩 워크플로우 — chip_buy_recommend(매수 추천), chip_hold_review(보유 종목 유지 판단), chip_market_analysis(시장 분석), portfolio_rebalance(포트폴리오 재구성), rebalance_full_workflow(풀 워크플로우) 등 시나리오별 프롬프트로 분석 흐름을 가이드합니다. 자동 운용은 Agent에서 「켜기/중지」칩·API로 제어하며 설명은 위 「자동 운용 (스케줄)」 절을 참고하세요. (에이전트 화면에서는 순위 종합·오늘 시황·자동 운용 안내 칩은 제공하지 않으며, 필요 시 프롬프트 이름을 직접 지정할 수 있습니다.)

분석 결과 예제

아래는 Agent가 여러 분석 도구를 활용해 생성한 실제 결과 예시입니다.

① 종목 상세 분석 — 카카오(035720)에 대해 멀티팩터 종합점수, 차트 패턴·OBV·뉴스·상대강도·펀더멘털 등 5가지 추천 사유를 종합해 제시합니다.

② 종합 비교표 — SK하이닉스·삼성전자·현대모비스·삼성물산·카카오 등 여러 종목의 멀티팩터·펀더멘털·상대강도·차트패턴·핵심 강점을 비교하고, 과매수·변동성·시장 환경에 대한 투자 유의사항을 안내합니다.

③ 실행 타임라인 — "오늘 시장 분석 및 예측해줘" 요청 시 Agent가 호출한 도구(getMultiFactorScore, getFundamentalValuationScore, getEventRiskScore, getFlowCompositeScore, getExtendedIndicatorsReport, detectChartPatterns, getPriceVolumeDivergence, getFinancialRatio, getStockNews, getRelativeStrength 등)를 단계별로 추적할 수 있습니다.