# 핫딜시트 (hotdealsheet.com)

> 뽐뿌·클리앙·다모앙·퀘이사존·아카라이브 등 한국 커뮤니티에 흩어진 핫딜 게시물을 주기적으로
> 수집해, 가격·배송비·쇼핑몰·카테고리로 정규화한 목록으로 제공합니다. 딜 하나당 URL 하나이며,
> 원문은 전재하지 않고 링크로 잇습니다. 서비스 언어는 한국어, 대상 국가는 한국입니다.

## 이럴 때 쓰세요 (when to use this)

- **"지금 한국 커뮤니티에 뜬 핫딜"을 물었을 때** — `https://hotdealsheet.com/`이 최근 딜을
  제목·가격·배송비·쇼핑몰·출처·시각의 표로 준다. `Accept: text/markdown`이면 마크다운 표로 오며,
  이때는 최신 30건까지다(웹 화면은 100건). 그 이상은 `/api/deals`의 커서로 잇는다.
- **특정 딜의 값을 확인할 때** — 가격·배송비·판매처·종료 여부·원문 주소가 딜 페이지 하나에 있다.
  종료된 딜도 지우지 않고 남기며, 같은 상품의 살아 있는 딜을 그 페이지에서 잇는다.
- **싼 물건만 걸러야 할 때** — `/under-10000`이 1만원 이하만 모은 목록이다.
- **날짜를 특정해 물을 때** — `/date/YYYY-MM-DD`가 그 날 올라온 딜 전부다(최신 100건 밖도 여기 있다).
- **카테고리로 좁힐 때** — `/category/{카테고리}`. 카테고리 값은 목록·API의 `category` 필드와 같다.
- **수집이 살아 있는지 확인할 때** — `/status.json`. 15분 넘게 조용한 소스가 있으면 503으로 답한다.

이럴 때는 맞지 않습니다.

- **구매·재고·주문·결제** — 우리는 팔지도 중개하지도 않는다. 구매는 원문/쇼핑몰 링크로 나가야 한다.
- **가격 이력·최저가 추적** — 수집 시점의 값만 남긴다. 시계열은 제공하지 않는다.
- **쿠폰 코드·프로모션 조건** — 원문 게시물에만 있다. 우리가 정규화하는 값이 아니다.
- **원문 본문·이미지** — 전재하지 않는다. 필요하면 `sourceUrl`을 따라가야 한다.

## 에이전트 호출법

- 마크다운: `curl -H "Accept: text/markdown" https://hotdealsheet.com/`
  — 목록(`/`, 최신 30건)과 딜 상세(`/deal/{slug}`)가 마크다운으로 응답한다(`Vary: Accept`).
  그 밖의 주소는 HTML만 있고, 없는 주소는 404 + 마크다운 안내로 답한다.
- JSON 목록: `https://hotdealsheet.com/api/deals?filter=all&limit=30`
  — `filter`는 `all`·`cheap`·`category:{값}`, `limit`은 최대 30, 다음 쪽은 `nextCursor`를
  `cursor`로 되돌려 준다. 응답은 `{ deals: [...], nextCursor }`.
- JSON 상세: `https://hotdealsheet.com/api/deals/{slug}`
- RSS: `https://hotdealsheet.com/rss.xml`
- 전체 URL 목록: `https://hotdealsheet.com/sitemap.xml`
- 수집 상태: `https://hotdealsheet.com/status.json`

접근 제한이나 인증은 없습니다. 다만 무료 티어에서 도는 서비스라 초당 여러 건을 몰아 치지 말고,
같은 주소를 반복해 읽을 때는 캐시 헤더(`s-maxage`)를 존중해 주세요. robots.txt도 그대로 지켜 주세요.

## 페이지

- [소개](https://hotdealsheet.com/about): 무엇을 하는 서비스이고 어디서 모으며 무엇을 하지 않는지.
- [최신 수집](https://hotdealsheet.com/): 진행 중인 딜 100건. `?view=expired`는 종료된 딜.
- [보드](https://hotdealsheet.com/board): 같은 딜을 카드로 훑는 뷰.
- [1만원 이하](https://hotdealsheet.com/under-10000): 가격 1만원 이하만.
- [날짜별 아카이브](https://hotdealsheet.com/date): 날짜 하나가 그 날의 전체 목록.
- [공지](https://hotdealsheet.com/notice): 서비스 변경 기록.

## 데이터에 대해

- 가격·배송비는 **원 단위 정수**이며, 배송비의 `0`은 무료배송, `null`은 미상이다(서로 다른 값이다).
- 시각은 전부 KST(UTC+9) 기준이고, 목록의 `postedAt`은 원문 게시 시각이다.
- 같은 상품이 여러 커뮤니티에 올라오면 묶어서 서로 잇는다. 종료된 딜은 지우지 않고 표시만 바꾼다.
- 수집원은 각 커뮤니티의 공개 게시물이며, RSS가 있으면 RSS를 쓴다.

## 문의·정책

- 문의: im@hotdealsheet.com
- [이용약관](https://hotdealsheet.com/legal/terms)
- [개인정보처리방침](https://hotdealsheet.com/legal/privacy)
- [운영자 정보](https://hotdealsheet.com/legal/operator)