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

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) 위에서 끝나는 조합.

• 무료 요금제 기준 스케줄 실행은 하루 1번 정도가 한도인 경우가 많은데, 이 프로젝트는 원래 “하루 1번 가상 매매”라 딱 맞음.
• 더 쉬운 대안(LiteLambda, n8n 같은 노코드 자동화 서비스)도 있지만, 새 계정·새 플랫폼을 추가로 배워야 해서 이미 GitHub을 쓰고 있는 케빈님껜 GitHub Actions 조합이 더 적은 노력으로 끝나는 길임.

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

• 실제 증권사 연동·실거래 (계속 가상 매매만)
• 로그인·회원가입 (누구나 그냥 보는 공개 페이지)
• 종목 10개 → 더 늘리기 (나중에 잘 되면 확장)
• 과거 몇 년치 시세 백테스트 (Finnhub 무료 플랜에 없음 — 매일 쌓아가는 걸로 대체, Day 4 사례 참고)

8. 다음 단계

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

1. GitHub Actions 워크플로 파일 만들기 (매일 실행)
2. Finnhub API로 가격+뉴스 가져와서 AI에게 넘기고 판단받는 스크립트 작성
3. 판단 결과를 JSON에 쌓는 로직 작성
4. Astro 대시보드 페이지 만들어서 그 JSON 표시