방법론
한 줄 요약 수집 주기와 관측 한계, 단가 계산 범위
수집 주기와 관측 한계, 단가 계산 범위
질문과 답
- Q. 가격은 얼마나 자주 수집하나요?
- A. 검색과 빌드는 매시간 :05에 시도합니다. 직전 한 시간에 호출 한도(4회)를 이미 다 썼으면 그 시간대는 건너뜁니다. 상품별 가격은 그 상품이 그 시간 검색 결과에 다시 나타났을 때만 재관측되므로 관측 간격이 상품마다 다릅니다.
- Q. 가격이 실제와 다를 수 있나요?
- A. 네. 숫자는 관측 시점의 기록이며 재고·배송·최종 결제가는 쿠팡 화면이 기준입니다.
- Q. 역대 최저가를 보장하나요?
- A. 아니요. 표시된 관측 구간 안의 최저·최고·평균만 말하고, 구간 밖은 단정하지 않습니다.
수집은 쿠팡파트너스 Open API(api-gateway.coupang.com) 또는 저장소의 seed fixture로만 합니다. coupang.com 화면을 프로그램으로 열지 않습니다.
관측 주기
표는 가로로 밀어서 볼 수 있습니다.
| 항목 | 주기·범위 | 확인 지점 |
|---|---|---|
| 검색 호출 | 매시간 :05 시도, 키워드 3개 회전 (시간당 호출 한도 4회 중 3회). 직전 한 시간에 한도를 이미 다 썼으면 그 시간대는 건너뜁니다 | scripts/hourly-live.sh |
| 새 상품 수집 | 위 검색 결과 중 저장소에 없는 상품만. 정시 크론 1회 신규 페이지 5개, 수동 빌드 기본 20개 · 사이트 전체 310p 상한 | build.py --limit · MAX_TOTAL_PAGES |
| 기존 상품 재관측 | 검색 결과에 다시 나타난 상품은 재관측으로 기록합니다. 검색에 안 나오면 관측하지 않습니다 | build.py fetch_live |
| 저장 단위 | 상품·관측일 1행. 같은 날 여러 번 확인하면 그날 마지막 값으로 갱신합니다 | price_history 기본키 |
| 빌드·배포 | 매시간 빌드하고, 게이트·테스트를 통과하고 내용이 바뀐 경우에만 배포합니다 | scripts/hourly-live.sh |
| 최근 7일 실제 실행 | 시작 140회 · 건너뜀 48회 (직전 시간 호출 한도 소진 등) · 전체 188슬롯 | out/hourly.log |
빌드는 매시간 실행되며, 같은 상품은 가격이나 관측 시각이 바뀌었을 때만 lastmod를 갱신합니다.
한 번의 빌드에서 새로 만드는 페이지는 기본 20개, 사이트 전체는 310개를 넘기지 않습니다.
단가는 상품명에서 용량을 읽었을 때만 계산합니다. 읽기에 실패하면 칸을 비우고 비교표에서 뺍니다. 추정 용량을 넣지 않습니다.
관측 최저·최고·평균은 저장된 이력의 구간 안에서만 말합니다. 역대 최저가라고 단정하지 않습니다.