본문으로 건너뛰기

PRD — 미국 주식 AI 모의매매 에이전트

김상빈

2026.07.28

로드맵의 "뭘·왜·누구를 위해"를 그대로 가져오고, 실제로 만들기 위해 빠져 있던 구체적인 것들(판단 근거·화면 구성·자본금·실행 주기·기술 방법)을 정한 문서.

1. 뭘·왜·누구를 위해 (로드맵에서 그대로)

  • 뭘: 미국 주식 중 내가 고른 10개 종목(AAPL·MSFT·NVDA·TSLA·AMZN·GOOGL·META·JPM·XOM·KO)을 두고, AI가 매일 가상(모의)의 돈으로 매매 판단을 내리고, 그 판단·수익률을 그래프로 보여주는 웹사이트.

  • 왜: 실제 돈을 쓰지 않고도 투자 전략(혹은 AI의 판단)이 괜찮은지 미리 확인해볼 수 있는 지표를 만들어보고 싶었고, 뉴스나 실제 사건이 주가에 얼마나·어떻게 영향을 주는지 직접 확인해보고 싶었다.

  • 누구를 위해: 케빈님 본인(학습·검증 목적) + 다른 사람도 볼 수 있게 공개하는 사이트 (로그인 없이 누구나 열람).

자세한 4주 계획은 4주 로드맵 참고. 이 문서는 그중 “만들기”를 실제로 시작할 수 있게 구체화한 것.

2. 매매 판단 근거 — 가격 + 뉴스, AI 종합 판단

매일 종목별로 그날의 가격 변화 + 최신 뉴스를 함께 AI에게 주고, AI가 종합적으로 “매수 / 매도 / 보유”를 판단한다.

  • 예: “TSLA는 오늘 뉴스가 긍정적이고 가격도 올랐으니 매수” 같은 식.

  • 판단할 때마다 왜 그렇게 판단했는지 이유(근거)도 함께 남긴다 — 대시보드에 그대로 노출할 것이므로, “이유 없음”은 없다.

  • 로드맵의 목적(“뉴스가 주가에 미치는 영향 확인”)과 가장 잘 맞는 방식.

3. 화면 구성 (대시보드)

한 화면에서 아래 3가지가 다 보여야 한다.

  1. 종목별 현재 상태 — 10개 종목 각각 지금 “보유중” 인지 “현금” 인지, 보유중이면 수량·평가금액

  2. 수익률 그래프 — 전체 포트폴리오($10,000 기준) 수익률이 날짜별로 어떻게 변해왔는지 꺾은선 그래프

  3. 매매 히스토리 + 이유 — “언제, 어떤 종목을, 왜 샀는지/팔았는지” 목록 (2번의 AI 판단 근거를 그대로 노출)

4. 가상 자본금

  • 총 $10,000을 10개 종목에 균등 분배 → 종목당 $1,000으로 시작

  • 매수 판단이 나면 그 종목에 배정된 현금 한도 내에서 매수, 매도 판단이 나면 보유분을 전량 매도해 현금으로 전환

  • 종목 간 자금을 서로 옮기지는 않는다 (각 종목은 독립된 $1,000 예산으로 시작해서 각자 굴러간다 — 종목별 성과 비교가 목적이므로)

5. 실행 주기

  • 매일 하루 1번, 자동 실행 (미국 장 마감 데이터 기준)

  • 사람이 매일 버튼을 누를 필요 없음 — 아래 6번 기술 방법으로 완전 자동화

6. 만드는 방법 — 지금 가장 쉬운 조합 (2026년 기준 조사)

이미 쓰는 도구(GitHub, Astro) 위에서 끝나는 조합.

역할

도구

왜 이걸

매일 자동 실행

GitHub Actions 예약 실행(cron)

새 서비스 가입 없이 이미 있는 저장소에서 바로 씀. 무료. 서버 관리 불필요

데이터 저장

JSON 파일 1개를 저장소에 계속 커밋

데이터베이스 없이 제일 간단. “매일 그날 기록 쌓기” 구조와 정확히 맞음

화면(대시보드)

Astro 페이지 1개 추가, 그 JSON을 읽어서 표+그래프로 렌더

이미 쓰는 프레임워크라 새로 배울 게 없음

배포

Vercel 또는 Netlify 무료 요금제, GitHub 연결

GitHub Actions가 매일 커밋 → 자동으로 사이트도 매일 다시 배포됨 (사람 개입 0)

  • 무료 요금제 기준 스케줄 실행은 하루 1번 정도가 한도인 경우가 많은데, 이 프로젝트는 원래 “하루 1번 가상 매매”라 딱 맞음.

  • 더 쉬운 대안(LiteLambda, n8n 같은 노코드 자동화 서비스)도 있지만, 새 계정·새 플랫폼을 추가로 배워야 해서 이미 GitHub을 쓰고 있을떄 GitHub Actions 조합이 더 적은 노력으로 끝나는 길임.

7. 이번엔 안 하는 것 (Out of scope)

  • 실제 증권사 연동·실거래 (계속 가상 매매만)

  • 로그인·회원가입 (누구나 그냥 보는 공개 페이지)

  • 종목 10개 → 더 늘리기 (나중에 잘 되면 확장)

  • 과거 몇 년치 시세 백테스트 (Finnhub 무료 플랜에 없음 — 매일 쌓아가는 걸로 대체, Day 3 사례 참고)

8. 다음 단계

이 PRD가 로드맵 2주차(“MVP 본격 제작”)의 설계도가 된다. 다음은:

  1. GitHub Actions 워크플로 파일 만들기 (매일 실행)

  2. Finnhub API로 가격+뉴스 가져와서 AI에게 넘기고 판단받는 스크립트 작성

  3. 판단 결과를 JSON에 쌓는 로직 작성

  4. Astro 대시보드 페이지 만들어서 그 JSON 표시

2

함께 이야기해요 2

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

아루나 프로필 이미지
아루나2026.07.30

N8n 대신에 깃허브 액션으로 하시기로 하셨군요 잘하셨습니다. 사실 n8n도 정말 좋은 도구지만 가벼운 mvp를 만들어서 지금이 프로젝트가 괜찮은지를 확인하기 위해 배우기에는 조금 무거운 감이 있죠. N8n으로 구현할수 있는건 보통 코드나 스크립트 정도로 빠르게 구현할 수 있는 경우가 많습니다. mvp는 빠르게 구현해 본 후 만약에 추후 계속 자동화가 필요하면은 n8n을 사용한 것도 좋은 방법입니다. N8n은 추론을 하지 않고 코드로 하기 때문에 토큰값을 아낄 수 있거든요.

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

PRD에서 가장 마음에 들었던 부분은 "이미 쓰는 도구(GitHub, Astro) 위에서 끝나는 조합"이라는 설계 원칙이에요. 새 플랫폼을 배우는 데 드는 비용을 인식하고, 이미 익숙한 것 위에서 최소한의 노력으로 완성하는 선택 — 실제로 만들어지는 프로젝트와 아이디어 단계에 머무는 프로젝트의 차이가 여기서 갈리는 경우가 많거든요.

종목별로 $1,000씩 독립 예산으로 굴려서 종목 간 성과를 비교한다는 설계도 깔끔하고, 특히 "판단 근거를 대시보드에 그대로 노출, '이유 없음'은 없다"는 기준이 좋아요. AI가 왜 그 판단을 했는지 추적할 수 있어야 뉴스가 주가에 미치는 영향을 실제로 확인할 수 있는 거니까요.

기지개 한 번 펴고... 다음 글도 기다릴게요 🐈‍⬛

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

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

이런 사례도 있어요

사례 전체 보기