AI 에이전트에게 Sephora에서 Rare Beauty의 Soft Pinch Liquid Blush가 얼마인지 물어보면, 가장 먼저 검색 결과인 "listPrice": "$16.00 - $25.00"을 보게 됩니다. 이 답변에 들어갈 숫자는 무엇일까요? $16은 3.2 mL 미니 사이즈입니다. $25는 7.5 mL 풀 사이즈입니다. 밀리리터당 계산했을 때, 미니 사이즈가 50% 더 비쌉니다.
이것은 드문 경우는 아닙니다. 저는 Sephora API에 쇼핑 질문 15개를 입력했고, 소비자가 실제로 타이핑하는 방식대로 작성했습니다. 그 결과 15개 제품 중 11개 제품에서 가격 대신 범위가 반환되었습니다. 검색 자체는 잘 작동했습니다. 첫 번째 결과는 15개의 질문 중 15개 모두 이름이 일치했습니다. 문제는 에이전트가 사이즈, 색상(shade), 그리고 매장을 선택해야 할 때 발생합니다.
제가 질문한 내용과 방법
질문들은 "dior lip glow oil", "tatcha water cream", "ysl libre perfume", "dyson airwrap", "olaplex no 3"와 같은 평범한 종류였으며, 메이크업, 스킨케어, 헤어, 향수 분야에서 총 열 가지가 더 있었습니다. 각 제품에 대해 저는 에이전트가 Sephora API에 연결되어 실행할 작업을 2026년 11월 4일 기준으로 시뮬레이션했습니다:
- 질문을 이용한
/search-by-keyword (검색어 기반 검색), 10개 결과.
- 소비자가 의도한 제품에 대한
/product-details, 이 엔드포인트는 모든 사이즈와 색상을 SKU(재고 관리 단위)로 나열합니다.
- 5개의 미국 도시(New York, Chicago, Los Angeles, Houston, Seattle) 중 한 곳을 기준으로 해당 제품의 기본 SKU에 대한
/product-availability (제품 가용성).
MCP 위에서 이들은 세 가지 도구입니다: RapidAPI의 게이트웨이가 API의 모든 엔드포인트를 하나로 만듭니다(연결 방법). 따라서 아래의 원시 응답은 모델이 정확히 읽을 수 있는 내용입니다. 총 116개의 검색 행, 140개 SKU가 포함된 15개 제품 기록, 그리고 204개 매장 행으로 구성되어 있습니다.
검색 가격은 보통 범위이다
| 제품 | 검색 결과 표시 가격 | 기본 SKU | 최적 가치 | 가장 작은 사이즈가 유리한 경우 |
|---|
| Rare Beauty Soft Pinch Blush | $16.00 - $25.00 | 7.5 mL, $25 | 7.5 mL, $3.33/mL | +50% |
| ... | | | | |
| In 11개 범위 중 9개에서 낮은 가격대는 가장 작은 사이즈의 가격입니다. Drunk Elephant의 Protini가 "$24부터"라고 보고하는 에이전트는 대부분의 사람이 50 mL에 구매하는 크림의 15 mL 용량을 인용하고 있습니다. 높은 가격대를 보고하는 에이전트는 종종 가장 큰 병을 인용합니다. 이 둘 다 쇼핑객이 의미하는 "얼마인가요?"라는 질문과는 거리가 멉니다. | | | | |
제품 기록 역시 이를 명확히 해주지 않습니다. 각 제품에는 기본 SKU(Product Details의 currentSku, 검색 행에서 15개 중 13개에 연결되는 동일한 SKU)가 있으며, 이는 종종 가장 저렴하거나 가장 일반적인 사이즈는 아닙니다. YSL Libre의 경우 $185짜리 90 mL 병이 기본 SKU입니다. Glow Recipe의 경우 검색 범위에서 언급되지 않는 40 mL, $36 제품이 기본 SKU입니다.
The smallest size costs up to 171% more per mL
밀리리터 또는 그램당 가격으로 볼 때, 사이즈 선택의 실제 폭이 있는 9개 제품 모두에서 가장 작은 사이즈가 비용 면에서 더 많이 들었습니다. 이는 최적 가치 사이즈보다 중앙값 기준으로 62% 더 높은 수치입니다. YSL Libre는 극단적인 예시입니다: 10 mL 스프레이는 $3.80/mL로 계산되는 반면, 최적 가치는 $1.40/mL입니다. 그리고 이 최적 가치가 가장 큰 병은 아닙니다. $140짜리 100 mL가 $185짜리 90 mL보다 저렴하며, isOnlineOnly: true 속성을 가진 유일한 SKU입니다. 크기를 육안으로 비교하는 에이전트는 이를 놓칠 수 있습니다. 하지만 가격을 mL당 계산하는 에이전트는 즉시 찾아냅니다.
쉐이드와 모델도 가격이 있다
One product, up to six prices
15개 제품 중 11개 제품은 SKU별로 여러 개의 권장 가격을 가지고 있었습니다. 크기(Sizes)가 대부분의 원인을 설명하지만, 모든 경우를 설명하지는 못합니다. 라네즈(Laneige)의 립 슬리핑 마스크는 대부분의 향에서 24달러이며, 그중 두 가지는 한정판인 세 가지 향에서는 25달러입니다. 샬롯 틸버리(Charlotte Tilbury)의 매트 레볼루션은 37달러인데, 두 가지 색상에서는 39달러입니다. 따라서 “Pillow Talk 립스틱은 얼마인가요?”라는 질문에 대한 정확한 답변은 에이전트가 색상을 SKU로 해결한 후에만 가능합니다.
Dyson의 경우는 또 다른 종류의 모호성입니다. “dyson airwrap”을 검색했을 때 상위 10개 결과에서 7가지의 다른 멀티 스타일러가 각각 649달러, 699달러, 749달러에 부속품과 함께 반환되었습니다. 에이전트가 자연스럽게 선택한 첫 번째 제품은 유일한 SKU에 isOutOfStock: true 상태였으며, 휴스턴 근처의 6개 매장 어디에서도 재고를 찾을 수 없었습니다. 이때 좋은 답변은 사용자에게 되묻는 질문입니다. 어떤 Airwrap 모델을 말씀하시는 건가요?
매장 재고: 라벨이 아닌 단위를 읽으세요
204개의 매장 행(store rows) 중 160개는 “재고 있음 (In Stock)”, 18개는 “한정 재고 (Limited Stock)”, 그리고 26개는 “재고 없음 (Out of Stock)”으로 표시되었습니다. 15개 제품 중 14개가 어느 곳에든 매대에 있었습니다. 에이전트에게 중요한 세 가지 세부 정보가 있습니다:
라벨은 단위 수량이 아닙니다. 4개의 매장 행은 정확히 1개의 재고를 가지고 “재고 있음”이라고 표시했습니다. 4개는 5개 이상, 최대 21개까지의 재고를 가지고 “한정 재고”라고 표시되었습니다 (휴스턴에서 The Ordinary 세럼). 만약 사용자가 어딘가로 운전해서 갈 예정이라면, 전달해야 할 수량은 inStoreAvailability입니다.
일부 매장은 Kohl's 내부에 있습니다. 204개 행 중 24개가 Kohl's 매장 내부의 Sephora 카운터였으며 (storeType이 SEPHORA가 아님), 이 중 15개 항목에 재고가 있었습니다. 이는 답변에서 언급할 가치가 있는데, “Jersey City의 Sephora”로 향하는 쇼핑객은 독립된 매장을 찾지 못하기 때문입니다.
검색 행의 픽업 플래그는 매장과 관련이 없습니다. 근처에 재고가 있는 14개 제품을 포함하여 모든 116개 검색 행에서 pickupEligible은 false였습니다. 이는 선반 상태가 아닌, 검색 컨텍스트를 설명합니다. “오늘 가져갈 수 있나요?”라는 질문에는 오직 /product-availability만이 답할 수 있습니다.
이 모든 과정에 추론할 모델은 필요하지 않습니다. 필요한 것은 산술 계산을 수행하고 모델에게 짧은 답변(사용자가 언급한 쉐이드의 가격별 mL 또는 g당 크기, SKU, 그리고 유닛과 함께 가장 가까운 매장 목록)을 전달하는 도구입니다. 여기에 RapidAPI 키를 사용하여 바로 실행할 수 있는 해당 도구가 있습니다:
"""AI 에이전트를 위한 Sephora API의 가격 및 재고 확인 도구.
검색(search), 제품 기록(product record), 매장 재고(store stock) 세 번 호출로, 작은 답변 하나를 얻습니다: 모든 크기별 정보와 함께...
타임스퀘어 근처에서 'Happy' 쉐이드의 블러셔를 검색했을 때, 이 도구는 SKU 2362085 (7.5 mL, $25, $3.33/mL)를 선택하고 두 가지 크기(전체 사이즈 14가지, 미니 사이즈 $5.00/mL 기준 8가지)를 각각 나열했으며, 유닛과 함께 가장 가까운 매장 5곳을 순서대로 반환했습니다. 전체 답변은 1,007자였습니다. 이 뒤에 숨겨진 세 가지 원본 응답은 제 테스트 호출에서 약 199,000자에 달합니다 (검색 13,228자, 제품 기록 129,780자, 매장 정보 약 55,700자). 이는 토큰당 네 글자를 기준으로 했을 때 대략 49,700 토큰에 해당합니다. 모든 모델의 토크나이저가 다르기 때문에 정확한 수치는 아니지만, 이 격차가 핵심입니다.
Claude 또는 다른 에이전트에게 전달하려면, 사용 중인 어떤 프레임워크에서든 check_price를 세 가지 입력값(query, option, 그리고 위치)을 가진 하나의 도구로 묶거나, 게이트웨이의 엔드포인트 도구 옆에 자체 MCP 서버의 도구로 구현해야 합니다.
데이터의 함정 (Pitfalls in the data)
크기 문자열은 자유 형식입니다. Fenty의 Gloss Bomb에는 10개의 SKU와 크기에 대한 7가지 철자가 있습니다. 그중 0.3 oz/ 9 mL, 0.30 oz, 0.3 oz/9 oz, 그리고 0.30 oz/9 g가 있습니다. Huda Beauty의 파우더에는 7가지가 있습니다. mL 또는 g 수치를 구문 분석하고, 크기 정보가 없는 경우 '알 수 없음'으로 처리해야 합니다. 네 개의 SKU는 아예 크기 정보가 없었습니다.
같은 크기라도 가격이 다릅니다. Sol de Janeiro의 Bum Bum Cream에는 $48과 $44에 각각 판매되는 두 가지 240 mL SKU가 있으며, 사이즈 필드 어느 곳에도 이들이 어떻게 다른지 설명하는 내용은 없습니다. Tatcha와 Drunk Elephant는 용기에 대한 정보 옆에 50 mL 리필 제품을 각각 $68과 $63에 나열하고 있습니다. 이런 경우 크기에는 '리필(Refill)'이라고 명시되어 있습니다. 사용자에게 두 가지 옵션을 모두 보여주어야 합니다.
미니 제품은 두 곳에 존재합니다. 미니 제품은 종종 메인 제품의 SKU(재고 관리 코드)이자 검색에서 별도의 "Mini..." 제품으로 나타납니다. 116개의 검색 결과 중 39개가 미니 또는 세트였습니다. 이 도구는 검색에서 "Mini" 제품을 건너뛰고 메인 레코드에서 미니 사이즈를 가져오므로, 각 사이즈가 한 번만 표시됩니다.
할인 상품은 드물며 salePrice에 존재합니다. 116개의 검색 결과 중 단 1개만 할인 판매 중이었습니다 (Charlotte Tilbury 미니 립스틱 세트, $26에서 $18.20으로). salePrice가 설정되어 있으면 그것이 현재 가격이며, listPrice는 이전 가격(was-price)입니다.
범위(range)와 레코드(record)가 불일치할 수 있습니다. 15개 제품 중 14개 제품의 경우, 검색 범위는 가장 낮은 SKU 가격과 가장 높은 SKU 가격과 정확히 일치했습니다. Laneige 마스크의 경우, 범위는 $23에서 시작했지만 제품 레코드의 모든 SKU는 $24 또는 $25였습니다. 레코드를 인용하십시오.
다음으로 제가 할 일
에이전트가 사용자 질문에 되묻지 않고 답변할 수 있도록 도구에 사이즈 선호도("평소 크기", "최적의 가치", "여행용 사이즈")를 추가하고, 가격은 재고보다 변화가 적으므로 제품 레코드를 하루 동안 캐싱(cache)해야 합니다.
Sephora API는 테스트를 위한 무료 플랜과 함께 RapidAPI에서 이용 가능합니다. 더 많은 예시는 GitHub의 Sephora API 저장소에 있으며, 데이터가 무엇을 포함하는지는 LinkedIn의 Sephora API 개요에서 다루고 있습니다. 뷰티 데이터를 기반으로 쇼핑 에이전트를 구축하거나 카탈로그를 데이터셋으로 필요로 하시나요? 연락 주십시오.