본문으로 건너뛰기

투자자동화 3] 나만의 투자의사결정 개인 비서 앱 초안 완성 (Investment Compass)

Develiper

2026.08.10

투자자동화 3] 나만의 투자의사결정 개인 비서 앱 초안 완성 (Investment Compass) 본문 이미지

투자의사결정(보유 종목 유지, 추가 매수, 매도, 신규 종목 발굴 및 매수 등)을 도와줄 personal 앱을 제가 쓸 수 있는 정도 수준으로 일단 만들었습니다.

아마 계속해서 수정 개선 보완해 가야 더 제 입맛에 맞고, 현명한 투자 의사결정을 도와줄 친구로 변신할 거라고 생각합니다.


투자나침반(Investment Compass) 앱 소개

1. 앱 개요

투자나침반(Investment Compass)은 국내 주식과 ETF 투자를 한곳에서 점검하고, 시장 상황과 보유 종목의 데이터를 바탕으로 다음 행동을 판단할 수 있도록 돕는 개인용 투자 관리·분석 대시보드입니다. 단순히 현재 수익률을 보여주는 데 그치지 않고, 여러 계좌의 자산 현황과 실현손익·배당금·세금·시장 흐름을 함께 연결해 투자자가 자신의 포트폴리오를 더 입체적으로 이해하도록 설계되었습니다.

이 앱은 특정 종목의 매매를 자동으로 실행하는 서비스가 아니라, 투자 판단에 필요한 정보와 분석 결과를 빠르게 확인하고 사용자가 최종 결정을 내릴 수 있도록 지원하는 의사결정 보조 도구를 지향합니다.

2. 주요 기능과 서비스

포트폴리오 통합 관리

- 여러 증권사·계좌의 주식과 ETF 보유 현황을 통합해서 조회

- 계좌별 보유 수량, 평균매수가, 평가금액, 평가손익, 수익률 확인

- 매수·매도·보유 수량 변경을 거래 내역 형태로 반영

- 실현손익과 배당금 수령 내역을 별도로 기록

- 키움·한국투자·NH 등 증권사 잔고 CSV를 불러와 계좌 잔고 동기화

- JSON 백업 및 복원을 통한 개인 데이터 보관과 이전

종목 진단과 퀀트 분석

각 종목을 다음 8가지 요소로 분석해 종합 점수와 판단 배지를 제공합니다.

1. 확정 실적 모멘텀

2. 외국인 수급

3. 기관 수급

4. 거래량 모멘텀

5. 차트 추세

6. 공시·뉴스 모멘텀

7. 밸류에이션

8. 업종·시장 대비 상대강도

분석 결과는 매수 후보, 보유, 비중 축소, 매도 경고 등의 형태로 표시되며, 사용 가능한 데이터의 비율을 바탕으로 판단 신뢰도도 함께 제시합니다. 데이터가 부족하거나 오래된 경우에는 분석 결과를 무리하게 확정하지 않고 STALE 또는 UNAVAILABLE 상태로 구분합니다.

시장·거시환경 모니터링

시장 개요 화면에서는 KOSPI, S&P 500, 외국인 누적 수급, 원/달러 환율과 주요 금리 흐름을 함께 살펴볼 수 있습니다. 이 지표들의 방향을 비교해 현재 시장을 위험선호·혼조·경계·위험회피 국면으로 분류하고, 신호가 서로 충돌하는 지점과 다음 거래일에 확인할 항목을 요약합니다. 미국 기준금리와 10년물 금리의 관계, 정책 일정, 글로벌 이벤트, 일일 뉴스 브리핑도 제공합니다.

거래 대시보드의 스크린샷

투자 실행을 돕는 부가 분석

- 관심 종목을 저장하고 종목 탐색기에서 보유 종목과 함께 비교

- 전체 시장을 대상으로 재무·수익률·배당 기준의 퀀트 스크리닝

- 목표 비중을 설정해 포트폴리오 리밸런싱을 가상으로 시뮬레이션

- ISA, 연금저축, IRP, 일반 계좌를 구분한 세금·공제 분석

- 종목별·업종별 실현손익, 평가손익, 배당금의 수익 기여도 분석

- 월별 배당 일정과 예상 현금흐름 확인

- 수급·가격·실적·뉴스 변화에 따른 알림과 웹 푸시 알림

- 모바일 홈 화면에 설치할 수 있는 PWA 지원

이름과 전화번호 목록이 포함된 웹사이트의 스크린샷

한국 증권 거래소 한국 증권 거래소 한국 증권 거래소 한국 증권 거래소 한국 증권 거래소

한국어 숫자와 그래프가 포함된 대시보드 스크린샷

그래프를 보여주는 한국 웹사이트의 스크린샷

3. 주요 특징

계좌 단위로 달라지는 판단

같은 종목이라도 계좌별 평균매수가와 보유 수량에 따라 손익률과 대응 방법이 달라질 수 있습니다. 투자나침반은 통합 포트폴리오뿐 아니라 선택한 계좌의 실제 보유분을 기준으로 종목 진단을 다시 계산해, 계좌별 상황에 맞는 정보를 보여줍니다.

데이터 출처와 최신성의 명시

시세·투자자별 수급은 한국투자증권 Open API, 기업 공시·재무정보는 Open DART, 환율·금리 등 거시지표는 한국은행 ECOS와 FRED, 통계는 KOSIS, 뉴스는 네이버 뉴스 API를 사용합니다. 각 데이터에는 출처, 기준 시각, 조회 시각, 품질 상태를 표시해 사용자가 분석 결과의 근거와 최신성을 확인할 수 있게 했습니다.

실시간 데이터와 장애 대응

보유 종목은 KIS WebSocket을 통해 실시간 체결가를 구독하고, 연결이 끊어진 경우에는 자동 재접속과 REST 기반 조회로 보완합니다. 외부 API가 일시적으로 unavailable하면 로컬 SQLite 캐시에 저장된 마지막 정상 데이터를 STALE 상태로 제공하므로 화면 전체가 즉시 비어 버리지 않습니다.

4. 개발 과정 및 구현 방식

처음에는 보유 자산과 계좌 정보를 관리하는 포트폴리오 화면을 중심으로 시작한 뒤, 실제 투자에 필요한 흐름을 단계적으로 확장하는 방식으로 개발되었습니다. 포트폴리오 입력과 거래 반영을 기반으로 종목 진단 엔진을 만들고, 이후 시장 분석, 스크리너, 리밸런싱, 세금, 배당, 수익 기여도 분석을 각각 독립적인 서비스와 화면으로 추가했습니다. 테스트 코드도 상태 저장소, CSV 가져오기, 백업·복원, 퀀트 점수와 투자자 수급 분석 등 핵심 로직을 중심으로 함께 구성했습니다.

프론트엔드는 React, TypeScript, Vite로 구현했으며, Zustand의 persist 기능으로 포트폴리오 데이터를 브라우저 로컬 저장소에 보존합니다. TanStack Query는 API 조회와 백그라운드 갱신을 담당하고, Recharts와 Lightweight Charts는 가격·수급·배당·자산배분 데이터를 시각화합니다. 화면 규모를 줄이고 초기 로딩을 빠르게 하기 위해 주요 모달과 분석 화면에는 지연 로딩을 적용했습니다.

백엔드는 FastAPI 기반의 로컬 Python 서버로 구성했습니다. 브라우저에 금융 API 인증키를 직접 노출하지 않고 백엔드가 외부 API를 호출하도록 분리했으며, 응답 정규화·재시도·호출 제한·캐싱을 서버에서 처리합니다. KIS WebSocket 실시간 시세, Open DART 기업 매핑 및 재무 조회, ECOS·FRED·KOSIS 거시·통계 조회를 하나의 앱 경험으로 통합한 구조입니다.

5. 사용 용도

투자나침반은 투자 데이터를 확인하는 시간과 목적에 따라 다양하게 활용할 수 있습니다.

일상적인 투자 루틴

- 장 시작 전: 시장 개요에서 KOSPI와 미국 지수, 환율, 금리, 외국인 수급을 확인하고 당일 주요 정책·경제 일정을 파악합니다.

- 장중: 실시간 시세와 투자자별 수급 변화를 확인하면서 보유 종목의 급격한 가격 변동이나 판단 신호 변화를 점검합니다.

- 장 마감 후: 계좌별 평가손익과 실현손익을 확인하고, 어떤 종목과 업종이 수익에 기여했는지 복기합니다.

- 주간·월간 단위: 포트폴리오의 자산배분, 종목별 비중, 배당 예정 금액, 관심 종목의 분석 결과를 비교하며 다음 투자 계획을 세웁니다.

상황별 활용 사례

새로운 종목을 찾을 때에는 종목 탐색기와 퀀트 스크리너로 후보를 좁힌 뒤, 개별 종목 상세 화면에서 실적·밸류에이션·차트·수급·공시·뉴스를 함께 확인할 수 있습니다. 단일 지표에 의존하지 않고 여러 신호가 같은 방향을 가리키는지 살펴보는 데 유용합니다.

보유 종목의 추가 매수를 고민할 때에는 현재 가격만 보는 대신 계좌별 평균매수가, 손익률, 보유 비중, 시장 국면, 외국인·기관 수급을 함께 확인할 수 있습니다. 분석 엔진이 제시하는 판단과 신뢰도, 부족하거나 오래된 데이터도 같이 확인해 성급한 추격 매수를 줄이는 참고 자료로 활용할 수 있습니다.

매도 또는 비중 조절을 검토할 때에는 종목별 손익뿐 아니라 해당 종목이 전체 포트폴리오에서 차지하는 비중과 수익 기여도를 살펴볼 수 있습니다. 리밸런싱 시뮬레이터를 이용하면 목표 비중에 맞춰 매수·매도했을 때의 변화도 사전에 점검할 수 있습니다.

실적 발표와 공시를 확인할 때에는 DART 기반의 기업 재무정보와 최근 공시를 종목별로 확인하고, 뉴스와 함께 실적 모멘텀의 방향을 살펴볼 수 있습니다. 분기별 실적 추세와 시장의 주요 이벤트를 한 흐름으로 연결해 투자 아이디어를 사후 검증하는 용도로도 사용할 수 있습니다.

배당 중심으로 자산을 관리할 때에는 월별 배당 일정과 예상 배당 현금흐름을 확인하고, 실제 수령 내역을 입력해 예상 금액과 비교할 수 있습니다. 배당 ETF와 개별 배당주의 현금흐름을 함께 관리할 수 있어 생활비 보조나 장기 현금흐름 계획을 세울 때 활용하기 좋습니다.

계좌와 세금 계획을 점검할 때에는 ISA, 연금저축, IRP, 일반 계좌를 구분해 납입액과 세제 혜택, 금융소득 현황을 확인할 수 있습니다. 증권사 CSV로 최신 잔고를 반영한 뒤 계좌별 자산배분과 세금 관련 지표를 함께 검토하면 연말 정리나 다음 연도 납입 계획을 세우는 데 도움이 됩니다.

투자 기록을 안전하게 보관할 때에는 포트폴리오와 설정 정보를 JSON 파일로 내보내 개인적으로 보관하거나, 기기 변경·브라우저 초기화 후 백업 파일을 이용해 복원할 수 있습니다. 모든 데이터가 외부 서버에 자동으로 공유되는 방식이 아니라 로컬 저장과 사용자가 직접 관리하는 백업을 중심으로 구성되어 개인용 기록 관리에도 적합합니다.

적합한 사용자

투자나침반은 여러 계좌를 동시에 운용하면서도 전체 자산을 한눈에 보고 싶은 투자자, 매매 기록과 배당금까지 직접 관리하고 싶은 투자자, 실적·수급·시장 흐름을 함께 고려해 투자 판단을 정리하고 싶은 투자자에게 적합합니다. 특히 투자 전에 확인할 항목을 체계화하고, 투자 후에는 결과를 수치로 복기하려는 장기 투자자에게 유용합니다.

결국 이 앱의 목적은 복잡하게 흩어진 투자 데이터를 한 화면에 모아 “지금 내 포트폴리오를 어떻게 바라보고, 무엇을 다음에 확인해야 하는가”에 답하는 것입니다. 분석 결과는 참고 자료이며, 실제 매매와 세금 신고에 앞서 최신 공시·거래 내역과 개인의 투자 원칙을 함께 확인해야 합니다.

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

박준_JoonLab 프로필 이미지
박준_JoonLab2026.08.19

여러 계좌 통합부터 8요소 종목 진단, 리밸런싱 시뮬레이션까지 개인용으로 쓸 수 있는 수준으로 다 붙여내셨네요! 특히 데이터가 부족하거나 오래되면 결과를 무리하게 확정하지 않고 STALE, UNAVAILABLE로 갈라놓으신 지점이 정말 좋습니다. 대개 여기를 생략하고 빈 값을 0으로 흘려보내다 판단이 조용히 망가지는데, Develiper님은 그 부분을 처음부터 잡고 가셨네요.

여기서 더 나아가신다면, 판단 신호가 바뀔 때 뜨는 알림에 그 순간의 8요소 원값을 스냅샷으로 같이 적재해두시면 좋을 것 같습니다. 예를 들어, 어떤 종목이 '보유'에서 '비중 축소'로 넘어간 날의 수급·밸류에이션 원값이 남아 있으면, 몇 달 뒤에 그 판단이 맞았는지를 기억이 아니라 기록으로 대조할 수 있거든요.

저는 이런 종합 판단을 남길 때 관측한 값과 거기서 끌어낸 결론을 물리적으로 나눠 적는데, 한 칸에 섞이면 결과가 어긋났을 때 데이터가 틀렸는지 해석이 틀렸는지 되짚을 수가 없어서요.

화이팅입니다!!

멍멍_ 프로필 이미지
멍멍_2026.08.12

저도 한번 써보고 싶을 정도인데요. '사여?'를 판단하기 좋은 것 같습니다^^ 그럼 이제 실전 검증으로...

뽀짝이 프로필 이미지
뽀짝이2026.08.10

Develiper님, 3편까지 이어오신 시리즈 잘 읽었어요!

설계에서 눈에 띄는 부분이 두 군데 있었어요. 하나는 API 키를 브라우저에 직접 노출하지 않고 FastAPI 백엔드에서만 외부 호출을 처리한 구조예요. 개인용 앱이라도 이 분리를 챙겨두면 나중에 환경이 바뀌거나 다른 사람과 공유할 때 훨씬 안전하게 유지할 수 있어서, 처음부터 이렇게 잡은 게 좋았어요.

다른 하나는 데이터가 부족하거나 오래됐을 때 결과를 무리하게 확정하지 않고 STALE / UNAVAILABLE 상태로 구분한 부분이에요. 투자 판단 도구에서 "모른다"를 명시하는 설계는 생각보다 하기 어려운데, 이걸 처음부터 넣었다는 게 인상 깊었어요. 8가지 퀀트 요소 중 데이터가 빠진 게 있으면 신뢰도 비율까지 함께 표시한다는 것도요.

장시작 전·장중·장마감 후 루틴으로 사용 시나리오를 구체화하신 것도, 그냥 만들어 놓는 게 아니라 실제로 쓸 흐름을 미리 설계했다는 게 느껴졌어요. 앞으로 계속 개선하실 때도 꼭 기록 남겨주세요. 꼬리 탁! 치고 응원하고 갈게요 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기