Stock Memo는 종목을 추천하는 서비스가 아니라, 매일 시장 데이터를 같은 형식으로 기록하고 날짜별로 복기하기 위해 직접 만든 개인용 도구다. 국내 시장과 나스닥, 환율을 확인하려고 여러 화면을 오가는 불편을 줄이는 것이 출발점이었다.
현재 운영 중인 화면과 데이터 흐름
공개 화면은 Vercel에서 제공되는 Next.js 애플리케이션이다. 브라우저는 날짜를 선택하면 GET /api/records?date=YYYY-MM-DD를 호출하고, 서버는 선택 날짜와 records 배열을 JSON으로 반환한다.
각 레코드에는 시각과 함께 코스피·코스닥의 개인, 외국인, 기관 순매수와 수량, 지수와 변동률, 누적 거래량·거래대금이 들어간다. 같은 레코드에서 나스닥 변동률과 원/달러 환율도 함께 읽어 한 화면에서 비교한다.
현재 실제 운영 화면은 날짜 선택을 기준으로 코스피·코스닥과 원/달러 환율을 요약하고, 개인·외국인·기관의 시간대별 수급 흐름을 같은 화면에 배치한다.
날짜를 바꾸면 해당 날짜의 시장 요약과 수급 그래프가 함께 갱신되므로, 서로 다른 화면을 오가지 않고 시간대별 흐름을 비교할 수 있다.
복기를 위해 넣은 기능
- 날짜별 조회: 오늘 화면에만 머물지 않고 과거 날짜의 레코드를 다시 불러온다.
- 요약 카드: 코스피·코스닥 변동률과 거래량·거래대금, 나스닥과 환율을 상단에서 먼저 확인한다.
- 시간대별 표와 차트: 수급 주체별 흐름과 지수 변화를 같은 시각 축에서 비교한다.
- 수동·자동 갱신: 새로고침 버튼을 제공하고, 화면이 보이는 동안에는 10분마다 현재 날짜 데이터를 조용히 다시 요청한다.
- 한글·영문 화면: 선택 언어는 브라우저의
localStorage에 저장한다.
직접 운영하며 확인한 현재 상태
2026년 8월 14일 운영 페이지와 API를 다시 요청했을 때 모두 HTTP 200을 반환했고, 날짜와 레코드 배열이 실제로 내려오는 것을 확인했다. 화면에는 준비 상태, 선택 날짜, 레코드 수, 최근 기록 시각과 화면 갱신 시각을 따로 표시한다.
현재 저장소의 수집기 원본 코드는 이 WordPress 프로젝트 안에서 확인되지 않았다. 따라서 데이터 제공처나 Python 수집 주기를 추정해 적지 않고, 실제 공개 서비스와 API 응답에서 확인된 구조만 기록한다.
현재 제약과 다음 개선
표시 값은 데이터 수집 시각과 제공처 상태에 따라 늦거나 비어 있을 수 있다. 휴장일과 데이터가 없는 날을 구분해 안내하지만, 이 화면만으로 투자 판단을 내려서는 안 된다. Stock Memo는 어디까지나 시장 흐름을 같은 형식으로 기록하고 복기하기 위한 도구다.
추후 특정 수급 변화에 대한 알림을 붙인다면 단순히 매 레코드마다 메시지를 보내기보다 상태 변화와 중복 억제를 함께 설계할 필요가 있다. 실제 서버에서 사용하는 방식은 Telegram 서버 오류 알림 구축 기록에 정리했다.
Stock Memo 실제 서비스
