search_folsn_products
폴슨 상품 검색 / Search Folsn products
폴슨(folsn)이 네이버 스마트스토어에서 직접 파는 상품을 상품 이름·옵션(용량·수량·색상·모델 번호)으로 찾습니다. 결과마다 판매가(원)·배송비·묶음 수량과 개당 환산가·재고 상태·구매 주소·가격 기록 시각·출처를 따로 돌려줍니다. 다른 쇼핑몰 가격이나 전체 최저가는 돌려주지 않습니다. 검색어는 한국어 상품명(브랜드 + 제품명 + 용량·수량)이 가장 잘 맞고, 등록된 영어 브랜드·상품명도 일부 지원합니다. matchStatus=needs_clarification이면 clarificationFields의 옵션을 사용자에게 되물으세요. 결과가 없으면 hint의 내용을 사용자에게 전해 주세요. 예: {"query": "쿤달 칫솔 16입", "limit": 5}
Search products sold directly by Folsn on its own Naver Smart Store (Korea) by product name and option (volume, count, color, model number). Each result returns price in KRW, shipping fee, bundle quantity with unit price, stock status, purchase URL, the time the price was recorded, and the source as separate fields. It does not return other stores' prices or market-wide lowest prices. Korean product names (brand + product + volume/count) match best; selected English brand and product names also work. Unknown English words remain unchanged. If matchStatus=needs_clarification, ask the user about the options in clarificationFields. If there are no results, relay the hint to the user. Example: {"query": "클로란 피오니 샴푸 400ml", "limit": 5}
輸入參數limitquery必填
get_folsn_product_offer
폴슨 상품 판매 조건 / Get Folsn product offer
검색 결과의 sku(스마트스토어 상품 번호)로 폴슨 상품 한 건의 판매 조건을 가져옵니다: 판매가(원)·배송비·쿠폰(현재는 수집하지 않아 null)·묶음 수량과 개당 환산가·재고 상태·구매 주소·가격 기록 시각·출처. 예: {"product_id": "13300090680"}
Get the sale terms of one Folsn product by its sku (Smart Store product number) from search_folsn_products: price in KRW, shipping fee, coupon (not collected yet, null), bundle quantity and unit price, stock status, purchase URL, price record time and source. Example: {"product_id": "13300090680"}
輸入參數product_id必填
search_catalog_products
전체 상품 원장 검색 / Search catalog products
보유 원장별 상품 후보를 이름·브랜드·모델·바코드로 찾습니다. 미검증 가공 필드는 상태로 표시하고 가격은 내지 않습니다. Search recorded catalog candidates across product sources; no price in search.
輸入參數limitquery必填
get_catalog_product
상품 마스터 상세 / Get catalog product
검색 결과의 productId로 허용된 상품 마스터 필드·출처·검증 상태를 조회합니다. Get whitelisted master fields and evidence for a search result productId.
輸入參數product_id必填
get_catalog_offers
상품 판매처 관측 / Get catalog offers
상품에 연결해 확인한 판매처 관측만 반환합니다: 공개 판매가·배송비·구매 링크·관측 시각. 관측이 30일보다 오래되었거나 확인되지 않은 값은 null입니다. 미연결 오퍼·시드 가격은 상품에 붙이지 않습니다. 폴슨이 수집한 판매처만 다루므로 가장 낮은 값도 전체 최저가가 아닙니다. Linked, checked seller observations only: public price, shipping fee, store link and observation time; fields stay null when unknown or older than 30 days. Unlinked offers and seed prices are never attached. Only sellers Folsn collected are covered, so the lowest value here is not a market-wide lowest price.
輸入參數limitproduct_id必填
search_beauty_products
화장품 표준 상품 검색 / Search beauty products
화장품 원장의 출처 미검증 상품 후보를 검색합니다. 인허가·가격·안전성은 보증하지 않습니다. Search cosmetic catalog candidates; approval, prices and safety remain unverified.
輸入參數limitquery必填skin_typefunctional_typeexclude_ingredients
get_beauty_product_detail
화장품 기준 원장 및 전성분 상세 / Get beauty product detail
출처 미검증 화장품 원장의 기본 정보만 조회합니다. 인허가·전성분은 개별 근거 확인 전까지 비웁니다. Get basic catalog fields; regulatory and ingredient claims are withheld pending verification.
輸入參數barcodebeauty_idproduct_name
compare_beauty_offers
화장품 판매 관측 확인 / Check beauty offers
개별 원천 검증된 오퍼만 표시합니다. 현재 구 뷰티 원장에는 검증된 오퍼가 없어 빈 목록을 반환합니다. Only verified offers; the old beauty ledger currently has none.
輸入參數barcodebeauty_id
analyze_ingredients
입력 성분명 분류 / Classify supplied ingredient names
사용자가 직접 입력한 성분명을 분류합니다. 상품 원장의 전성분 출처와 피부 적합성은 확인되지 않았습니다. Classify user-supplied ingredient names; no product-specific ingredient or skin-safety claim.
輸入參數ingredients_textproduct_name_or_id
verify_cosmetic_safety
화장품 안전 자료 확인 상태 / Cosmetic safety record status
공개 검증 가능한 인허가·회수 원천이 없어 상태를 미확인으로 반환합니다. 회수 기록 없음은 안전 판정이 아닙니다. No verified regulatory source is connected; absence of a recall row does not establish safety.
輸入參數barcode_or_name必填