스팀 리뷰 탈곡기 (steam-review-bot) v4
스팀 게임의 유저 리뷰를 언어별로 나눠 평가와 이유를 정리하는 웹 서비스입니다.
숫자는 코드가 스팀에서 받아 계산하고, AI는 무작위로 뽑은 리뷰 표본을 읽고 해석만 합니다.
한눈에 보는 구조
방문자 ─ 웹(Vercel, Next.js) ──요청──▶ DB(Supabase, thresher 구역)
│ ▲
└─ GitHub Actions 깨우기 ──▶ 분석 실행기 ─ 스팀(숫자·리뷰·공지) ─ Gemini(해석) ─┘
- 웹: 홈(요청·목록) · 리포트 · 분석 방법 · 관리자 · 화면 문구 관리
- 분석 실행기:
scripts/run_analysis.ts — GitHub Actions(analyze-report.yml)가 분석 ID 하나를 받아 실행
- DB: Supabase 프로젝트 안의
thresher 구역(전용 계정 thresher_app). 구조는 db/schema.sql
분석 원칙
- 숫자는 코드가 — 스팀이 알려 주는 "조건에 맞는 긍정/부정 건수"를 그대로 가져옵니다(전체·기간별·언어별·플레이타임별). 95% 신뢰 구간과 "우연일 수 있는 변화" 판정을 함께 계산합니다.
- 기준은 게임마다 — 분석 기간(리뷰량), 플레이타임 구간(그 게임 리뷰어 분포의 사분위), 변화 판정(그 게임이 평소 흔들리는 폭)을 모두 그 게임 자신의 데이터로 정합니다. 고정 숫자 기준을 쓰지 않습니다. 직전 기간이 평소와 달랐으면(리뷰가 몰린 때) 변화 해석을 막고 알립니다.
- 표본은 치우치지 않게 — 분석 기간을 5구간으로 나눠 무작위로 뽑고, 언어 안에서 긍정/부정을 실제 비율대로 뽑습니다(도움순은 비판적인 글에 치우쳐 쓰지 않음).
- AI는 해석만 — 주제를 찾고 근거 리뷰 번호만 가리킵니다. 번호 검증, 주제 비중, 추천 비율은 코드가 계산하고 인용 원문은 DB의 실제 리뷰를 붙입니다. 원인 추측은 금지합니다.
- 언어 기준 — 국가가 아니라 리뷰를 쓴 언어입니다. 모든 화면에 그렇게 표시합니다.
- 실패를 숨기지 않기 — 수집이 실패하면 0으로 채우지 않고 실패와 이유를 보여 주며, 방문자의 오늘 한도 1칸은 돌려줍니다.
방문자 요청과 한도
- 누구나 요청할 수 있고, 같은 게임의 리포트가 있으면 "그 리포트 볼래요 / 새로 분석할래요"를 먼저 고르게 합니다. 같은 게임이 진행 중이면 그 분석으로 안내합니다(게임당 동시 1건).
- 방문자의 새 분석은 하루 30회(한국 시간 자정에 초기화). 관리자 화면에서 바로 바꿀 수 있습니다. 한도 확인과 접수는 DB 함수(
take_daily_slot)로 한 번에 처리해 동시에 눌러도 넘지 않습니다.
- AI 호출은 월 상한(기본 300회)이 있어, 닿으면 숫자만 저장합니다.
개발
npm install
npm test # 계산 로직 시험
npm run typecheck
npm run dev # http://localhost:3000
npm run analyze -- --new <App ID> # 내 컴퓨터에서 분석 한 건 실행 (.env.local 필요)
배포·환경변수·비밀값 설정은 docs/DEPLOY.md를 보세요.
예전 방식(v1~v3)
구글 시트에 저장하던 시절(2026-04~08)의 리포트 20건은 DB로 옮겨 "예전 방식" 표시와 함께 보관합니다.
숫자 기준(공식 평가 표기, 표본 방식)이 달라 새 리포트와 직접 비교하지 않습니다.
