# hwcmp

> 2016~2026년에 출시된 GPU(데스크톱·노트북·워크스테이션·데이터센터·PC 내장·모바일 SoC·임베디드/콘솔)의 공개 스펙을 한 스키마로 모은 읽기 전용 데이터셋과 비교 도구다. 로그인 없이 읽기 전용 REST API 로 조회한다.

라온데이터가 같은 스펙을 LLM 에 반복해서 묻지 않으려고 만든 도구다. 아래 규칙을 먼저 읽고 값을 쓴다.

- 값이 `null` 이면 모르는 값이다. 0 이 아니다. 추정치로 채워 넣지 않았다.
- 성능 수치(`*_tflops`, `*_tops`)는 부스트 클럭 기준 이론 최대치다. 실측 성능이 아니다.
- 텐서 수치(`tensor_*`)는 희소성을 적용하지 않은 dense 값이다. 제조사 자료의 sparse 수치는 보통 이 값의 2배다.
- 단위는 필드 이름 끝에 있다(`_gb` GB, `_gbs` GB/s, `_w` W, `_mhz` MHz, `_usd` USD). JSON Schema 의 `x-unit` 에도 적혀 있다.
- `memory_size_gb` 는 전용 VRAM 이다. 시스템 메모리를 함께 쓰는 GPU(PC 내장·Apple·모바일 SoC)는 `null` 이고, 통합 메모리 최대치는 `notes` 에 있다.
- 노트북 `tdp_w` 는 최대 TGP, `tdp_min_w` 는 최소 TGP 다.
- 같은 칩이라도 이름이나 메모리 용량이 다르면 별도 레코드다(예: RTX 3060 12GB / 8GB).
- 근거는 제조사 공식 사양을 우선으로 TechPowerUp·Notebookcheck·보도 자료다. 필드별 출처는 없다. 출시월·일부 클럭처럼 확신이 낮은 값이 섞여 있으니, 구매·용량 산정처럼 결과가 큰 판단에는 제조사 원문으로 다시 확인한다.

응답 필드는 camelCase 다(`release_date` → `releaseDate`). 쿼리 파라미터는 snake_case 다. 레코드 전체를 한 번에 내려받는 파일은 없다 — 목록은 페이지(최대 100건)로 나눠 받는다.

## API

GET 만 있고 인증은 없다. 요청은 클라이언트별로 제한되고 넘으면 `429` 와 `Retry-After`(초)가 온다. 그 초만큼 기다린 뒤 다시 부른다.

- [OpenAPI 명세](https://hwcmp.raondata.ai/api/openapi.json): 경로와 쿼리 파라미터 전체. `servers` 가 `/api` 다
- `GET /api/gpus?q=4090&vendor=NVIDIA&segment=desktop&sort=fp32_tflops&order=desc&page=0&size=20`: 목록·검색. 응답은 `{page, size, count, total, result}`. 페이지는 0 부터, `size` 최대 100. 여러 값 필터는 같은 키를 반복한다(`vendor=NVIDIA&vendor=AMD`). 이름 부분 일치는 `name`. 범위 필터는 `{필드}_min`/`{필드}_max`(`release_year`·`fp32_tflops`·`memory_size_gb`·`memory_bandwidth_gbs`·`tdp_w`·`launch_price_usd`)이고, 조건이 걸린 필드가 `null` 인 GPU 는 빠진다
- `GET /api/gpus/{id}`: GPU 한 건. `id` 는 `{제조사}-{모델명}` 소문자 slug 이고 목록·검색 결과의 `id` 를 쓴다
- `GET /api/gpus/compare?ids={id}&ids={id}`: 2~6개 비교. 수치 필드별 가장 좋은 GPU 를 `best` 로 준다(`processNm`·`tdpW`·`launchPriceUsd` 는 작을수록 좋음)
- `GET /api/gpus/{id}/similar`: 같은 구분에서 FP32(없으면 메모리 대역폭)가 가장 가까운 GPU
- `GET /api/gpus/facets`: 제조사·구분·아키텍처·출시 연도별 건수. 필터에 쓸 값 목록

## 웹 화면

- [목록·검색](https://hwcmp.raondata.ai/): 사람용 화면(JavaScript 필요). 에이전트는 위 API 를 쓴다
- 상세: `https://hwcmp.raondata.ai/gpus/{id}`
- 비교: `https://hwcmp.raondata.ai/compare?ids={id}&ids={id}` — 2~4개. 사람에게 비교 결과를 보여 줄 링크로 쓴다