Folsn Own-Store Products
Search Folsn own-store products with recorded KRW prices, options, shipping and purchase URLs.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (2)
- LOWin compare_beauty_offers
- LOWin analyze_ingredients
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"own-store-products": {
"url": "https://mcp.folsn.com/public/mcp"
}
}
}Remote-Endpunkte
https://mcp.folsn.com/public/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (7)
🟢search_folsn_products(query, limit)
폴슨(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. 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}
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"description": "상품 이름·옵션 검색어 또는 sku / product name and options, or sku",
"examples": [
"쿤달 칫솔 16입",
"클로란 피오니 샴푸 400ml"
],
"maxLength": 100,
"minLength": 1,
"title": "Query",
"type": "string"
},
"limit": {
"default": 5,
"description": "최대 결과 수(1~10) / max results",
"examples": [
5
],
"maximum": 10,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"query"
],
"title": "search_folsn_productsArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"matchStatus": {
"enum": [
"exact",
"candidate",
"needs_clarification",
"no_match"
],
"title": "Matchstatus",
"type": "string"
},
"clarificationFields": {
"items": {
"type": "string"
},
"title": "Clarificationfields",
"type": "array"
},
"resultCount": {
"title": "Resultcount",
"type": "integer"
},
"results": {
"items": {
"$ref": "#/$defs/FolsnOffer"
},
"title": "Results",
"type": "array"
},
"hint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Hint"
},
"relatedResults": {
"items": {
"$ref": "#/$defs/FolsnOffer"
},
"title": "Relatedresults",
"type": "array"
},
"notice": {
"default": "폴슨(folsn)이 네이버 스마트스토어에서 직접 파는 상품만 담습니다. 가격·배송비는 표시된 기록 시각(priceRecordedAt, 원천 기록이 갱신된 시각)의 값이며 판매처에서 다시 확인한 값이 아닙니다. 구매 직전 가격과 다를 수 있습니다. 가격은 같은 구성(compositionKey: 용량·수량)끼리만 비교하세요. 품절 상품의 기록 가격은 현재 구매 가능한 가격이 아니며 재고를 별도로 확인한 시각은 제공하지 않습니다. / Folsn's own Naver Smart Store products only. Prices are values as of the shown record time (priceRecordedAt, when the source record was last updated), not re-checked at the store, and may differ at checkout. Compare prices only within the same compositionKey. A recorded price for an out-of-stock item is not a currently purchasable price; no separate stock verification time is provided.",
"title": "Notice",
"type": "string"
}
},
"required": [
"query",
"matchStatus",
"resultCount"
],
"$defs": {
"BundleInfo": {
"additionalProperties": false,
"description": "묶음 수량과 개당 환산가(표준에 없음. schema.org UnitPriceSpecification·eligibleQuantity에 가깝다).",
"properties": {
"quantity": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Quantity"
},
"unitText": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Unittext"
},
"unitPrice": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Unitprice"
},
"status": {
"enum": [
"known",
"unknown",
"ambiguous"
],
"title": "Status",
"type": "string"
},
"basis": {
"default": "판매가 ÷ 수량(배송비 제외, 원 미만 반올림) / price ÷ quantity, shipping excluded",
"title": "Basis",
"type": "string"
},
"recordedAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recordedat"
},
"tokens": {
"items": {
"type": "string"
},
"title": "Tokens",
"type": "array"
}
},
"required": [
"status"
],
"title": "BundleInfo",
"type": "object"
},
"CouponInfo": {
"additionalProperties": false,
"description": "쿠폰(표준에 없음). v0은 쿠폰을 수집하지 않아 항상 coupon=null로 나간다.",
"properties": {
"value": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Value"
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Condition"
},
"recordedAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recordedat"
}
},
"title": "CouponInfo",
"type": "object"
},
"FolsnOffer": {
"additionalProperties": false,
"description": "폴슨 상품 한 건의 판매 조건(schema.org Offer 기준).",
"properties": {
"name": {
"title": "Name",
"type": "string"
},
"sku": {
"title": "Sku",
"type": "string"
},
"options": {
"$ref": "#/$defs/OptionTokens"
},
"compositionKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Compositionkey"
},
"price": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Price"
},
"priceCurrency": {
"const": "KRW",
"default": "KRW",
"title": "Pricecurrency",
"type": "string"
},
"priceRecordedAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Pricerecordedat"
},
"priceTimeBasis": {
"anyOf": [
{
"enum": [
"store_record_update",
"master_row_update",
"catalog_row_update"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Pricetimebasis"
},
"priceStatus": {
"enum": [
"known",
"unknown",
"stale"
],
"title": "Pricestatus",
"type": "string"
},
"shippingDetails": {
"$ref": "#/$defs/ShippingDetails"
},
"coupon": {
"anyOf": [
{
"$ref": "#/$defs/CouponInfo"
},
{
"type": "null"
}
],
"default": null
},
"bundle": {
"$ref": "#/$defs/BundleInfo"
},
"availability": {
"anyOf": [
{
"enum": [
"https://schema.org/InStock",
"https://schema.org/OutOfStock",
"https://schema.org/Discontinued"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Availability"
},
"availabilityStatus": {
"enum": [
"in_stock",
"out_of_stock",
"not_for_sale",
"unknown"
],
"title": "Availabilitystatus",
"type": "string"
},
"seller": {
"$ref": "#/$defs/Seller"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"pricePosition": {
"$ref": "#/$defs/PricePosition"
},
"source": {
"$ref": "#/$defs/OfferSource"
}
},
"required": [
"name",
"sku",
"options",
"priceStatus",
"shippingDetails",
"bundle",
"availabilityStatus",
"seller",
"pricePosition",
"source"
],
"title": "FolsnOffer",
"type": "object"
},
"MonetaryAmount": {
"additionalProperties": false,
"description": "schema.org MonetaryAmount(부분). value=None이면 모른다는 뜻(0원이 아니다).",
"properties": {
"value": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Value"
},
"currency": {
"const": "KRW",
"default": "KRW",
"title": "Currency",
"type": "string"
}
},
"title": "MonetaryAmount",
"type": "object"
},
"OfferSource": {
"additionalProperties": false,
"description": "출처(표준에 없음). 공개판은 폴슨 자사 상품 기록만 쓴다.",
"properties": {
"dataScope": {
"const": "folsn_own_products",
"default": "folsn_own_products",
"title": "Datascope",
"type": "string"
},
"priceRecord": {
"anyOf": [
{
"enum": [
"smartstore_sale_record",
"store_master_record",
"catalog_row_update"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Pricerecord"
},
"note": {
"default": "폴슨이 직접 판매하는 상품의 자체 기록입니다. 다른 쇼핑몰 가격은 포함하지 않습니다. / Folsn's own store records only; no other stores' prices.",
"title": "Note",
"type": "string"
}
},
"title": "OfferSource",
"type": "object"
},
"OptionTokens": {
"additionalProperties": false,
"description": "상품 이름에 적힌 옵션 토큰(표준에 없음. schema.org additionalProperty에 가깝다).",
"properties": {
"modelNumbers": {
"items": {
"type": "string"
},
"title": "Modelnumbers",
"type": "array"
},
"capacities": {
"items": {
"type": "string"
},
"title": "Capacities",
"type": "array"
},
"packCounts": {
"items": {
"type": "string"
},
"title": "Packcounts",
"type": "array"
},
"colors": {
"items": {
"type": "string"
},
"title": "Colors",
"type": "array"
}
},
"title": "OptionTokens",
"type": "object"
},
"PricePosition": {
"additionalProperties": false,
"description": "폴슨 가격의 상대 위치만 담습니다(같음·구간·모름). 금액·판매처·출처는 없습니다. / Relative position of Folsn's delivered price only; no amounts, sellers or sources.",
"properties": {
"status": {
"enum": [
"matches_lowest",
"higher",
"unknown"
],
"title": "Status",
"type": "string"
},
"percentBand": {
"anyOf": [
{
"enum": [
"1-5",
"5-10",
"10-20",
"20-50"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Percentband"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Label"
},
"basis": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Basis"
},
"sourceType": {
"anyOf": [
{
"const": "price_comparison_observation",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sourcetype"
},
"recordedAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recordedat"
},
"reason": {
"anyOf": [
{
"enum": [
"not_provided",
"no_basis",
"no_own_total",
"stale_basis",
"own_record_time_mismatch",
"inconsistent"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Reason"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Note"
}
},
"required": [
"status"
],
"title": "PricePosition",
"type": "object"
},
"Seller": {
"additionalProperties": false,
"description": "schema.org seller(Organization)의 name. platform은 표준에 없음.",
"properties": {
"name": {
"title": "Name",
"type": "string"
},
"platform": {
"const": "네이버 스마트스토어",
"default": "네이버 스마트스토어",
"title": "Platform",
"type": "string"
}
},
"required": [
"name"
],
"title": "Seller",
"type": "object"
},
"ShippingDetails": {
"additionalProperties": false,
"description": "schema.org OfferShippingDetails(부분: shippingRate). status·recordedAt·note는 표준에 없음.",
"properties": {
"shippingRate": {
"$ref": "#/$defs/MonetaryAmount"
},
"status": {
"enum": [
"known",
"free",
"unknown"
],
"title": "Status",
"type": "string"
},
"recordedAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recordedat"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Note"
}
},
"required": [
"shippingRate",
"status"
],
"title": "ShippingDetails",
"type": "object"
}
},
"additionalProperties": false,
"title": "SearchFolsnProductsOut"
}🟢get_folsn_product_offer(product_id)
검색 결과의 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"}
Eingabe-Schema
{
"type": "object",
"properties": {
"product_id": {
"description": "검색 결과의 sku(스마트스토어 상품 번호) / sku from search_folsn_products",
"examples": [
"13300090680"
],
"maxLength": 64,
"minLength": 1,
"pattern": "^[0-9A-Za-z_-]+$",
"title": "Product Id",
"type": "string"
}
},
"required": [
"product_id"
],
"title": "get_folsn_product_offerArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"productId": {
"title": "Productid",
"type": "string"
},
"matchStatus": {
"enum": [
"found",
"not_found",
"multiple"
],
"title": "Matchstatus",
"type": "string"
},
"offers": {
"items": {
"$ref": "#/$defs/FolsnOffer"
},
"title": "Offers",
"type": "array"
},
"notice": {
"default": "폴슨(folsn)이 네이버 스마트스토어에서 직접 파는 상품만 담습니다. 가격·배송비는 표시된 기록 시각(priceRecordedAt, 원천 기록이 갱신된 시각)의 값이며 판매처에서 다시 확인한 값이 아닙니다. 구매 직전 가격과 다를 수 있습니다. 가격은 같은 구성(compositionKey: 용량·수량)끼리만 비교하세요. 품절 상품의 기록 가격은 현재 구매 가능한 가격이 아니며 재고를 별도로 확인한 시각은 제공하지 않습니다. / Folsn's own Naver Smart Store products only. Prices are values as of the shown record time (priceRecordedAt, when the source record was last updated), not re-checked at the store, and may differ at checkout. Compare prices only within the same compositionKey. A recorded price for an out-of-stock item is not a currently purchasable price; no separate stock verification time is provided.",
"title": "Notice",
"type": "string"
}
},
"required": [
"productId",
"matchStatus"
],
"$defs": {
"BundleInfo": {
"additionalProperties": false,
"description": "묶음 수량과 개당 환산가(표준에 없음. schema.org UnitPriceSpecification·eligibleQuantity에 가깝다).",
"properties": {
"quantity": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Quantity"
},
"unitText": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Unittext"
},
"unitPrice": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Unitprice"
},
"status": {
"enum": [
"known",
"unknown",
"ambiguous"
],
"title": "Status",
"type": "string"
},
"basis": {
"default": "판매가 ÷ 수량(배송비 제외, 원 미만 반올림) / price ÷ quantity, shipping excluded",
"title": "Basis",
"type": "string"
},
"recordedAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recordedat"
},
"tokens": {
"items": {
"type": "string"
},
"title": "Tokens",
"type": "array"
}
},
"required": [
"status"
],
"title": "BundleInfo",
"type": "object"
},
"CouponInfo": {
"additionalProperties": false,
"description": "쿠폰(표준에 없음). v0은 쿠폰을 수집하지 않아 항상 coupon=null로 나간다.",
"properties": {
"value": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Value"
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Condition"
},
"recordedAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recordedat"
}
},
"title": "CouponInfo",
"type": "object"
},
"FolsnOffer": {
"additionalProperties": false,
"description": "폴슨 상품 한 건의 판매 조건(schema.org Offer 기준).",
"properties": {
"name": {
"title": "Name",
"type": "string"
},
"sku": {
"title": "Sku",
"type": "string"
},
"options": {
"$ref": "#/$defs/OptionTokens"
},
"compositionKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Compositionkey"
},
"price": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Price"
},
"priceCurrency": {
"const": "KRW",
"default": "KRW",
"title": "Pricecurrency",
"type": "string"
},
"priceRecordedAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Pricerecordedat"
},
"priceTimeBasis": {
"anyOf": [
{
"enum": [
"store_record_update",
"master_row_update",
"catalog_row_update"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Pricetimebasis"
},
"priceStatus": {
"enum": [
"known",
"unknown",
"stale"
],
"title": "Pricestatus",
"type": "string"
},
"shippingDetails": {
"$ref": "#/$defs/ShippingDetails"
},
"coupon": {
"anyOf": [
{
"$ref": "#/$defs/CouponInfo"
},
{
"type": "null"
}
],
"default": null
},
"bundle": {
"$ref": "#/$defs/BundleInfo"
},
"availability": {
"anyOf": [
{
"enum": [
"https://schema.org/InStock",
"https://schema.org/OutOfStock",
"https://schema.org/Discontinued"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Availability"
},
"availabilityStatus": {
"enum": [
"in_stock",
"out_of_stock",
"not_for_sale",
"unknown"
],
"title": "Availabilitystatus",
"type": "string"
},
"seller": {
"$ref": "#/$defs/Seller"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"pricePosition": {
"$ref": "#/$defs/PricePosition"
},
"source": {
"$ref": "#/$defs/OfferSource"
}
},
"required": [
"name",
"sku",
"options",
"priceStatus",
"shippingDetails",
"bundle",
"availabilityStatus",
"seller",
"pricePosition",
"source"
],
"title": "FolsnOffer",
"type": "object"
},
"MonetaryAmount": {
"additionalProperties": false,
"description": "schema.org MonetaryAmount(부분). value=None이면 모른다는 뜻(0원이 아니다).",
"properties": {
"value": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Value"
},
"currency": {
"const": "KRW",
"default": "KRW",
"title": "Currency",
"type": "string"
}
},
"title": "MonetaryAmount",
"type": "object"
},
"OfferSource": {
"additionalProperties": false,
"description": "출처(표준에 없음). 공개판은 폴슨 자사 상품 기록만 쓴다.",
"properties": {
"dataScope": {
"const": "folsn_own_products",
"default": "folsn_own_products",
"title": "Datascope",
"type": "string"
},
"priceRecord": {
"anyOf": [
{
"enum": [
"smartstore_sale_record",
"store_master_record",
"catalog_row_update"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Pricerecord"
},
"note": {
"default": "폴슨이 직접 판매하는 상품의 자체 기록입니다. 다른 쇼핑몰 가격은 포함하지 않습니다. / Folsn's own store records only; no other stores' prices.",
"title": "Note",
"type": "string"
}
},
"title": "OfferSource",
"type": "object"
},
"OptionTokens": {
"additionalProperties": false,
"description": "상품 이름에 적힌 옵션 토큰(표준에 없음. schema.org additionalProperty에 가깝다).",
"properties": {
"modelNumbers": {
"items": {
"type": "string"
},
"title": "Modelnumbers",
"type": "array"
},
"capacities": {
"items": {
"type": "string"
},
"title": "Capacities",
"type": "array"
},
"packCounts": {
"items": {
"type": "string"
},
"title": "Packcounts",
"type": "array"
},
"colors": {
"items": {
"type": "string"
},
"title": "Colors",
"type": "array"
}
},
"title": "OptionTokens",
"type": "object"
},
"PricePosition": {
"additionalProperties": false,
"description": "폴슨 가격의 상대 위치만 담습니다(같음·구간·모름). 금액·판매처·출처는 없습니다. / Relative position of Folsn's delivered price only; no amounts, sellers or sources.",
"properties": {
"status": {
"enum": [
"matches_lowest",
"higher",
"unknown"
],
"title": "Status",
"type": "string"
},
"percentBand": {
"anyOf": [
{
"enum": [
"1-5",
"5-10",
"10-20",
"20-50"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Percentband"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Label"
},
"basis": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Basis"
},
"sourceType": {
"anyOf": [
{
"const": "price_comparison_observation",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sourcetype"
},
"recordedAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recordedat"
},
"reason": {
"anyOf": [
{
"enum": [
"not_provided",
"no_basis",
"no_own_total",
"stale_basis",
"own_record_time_mismatch",
"inconsistent"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Reason"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Note"
}
},
"required": [
"status"
],
"title": "PricePosition",
"type": "object"
},
"Seller": {
"additionalProperties": false,
"description": "schema.org seller(Organization)의 name. platform은 표준에 없음.",
"properties": {
"name": {
"title": "Name",
"type": "string"
},
"platform": {
"const": "네이버 스마트스토어",
"default": "네이버 스마트스토어",
"title": "Platform",
"type": "string"
}
},
"required": [
"name"
],
"title": "Seller",
"type": "object"
},
"ShippingDetails": {
"additionalProperties": false,
"description": "schema.org OfferShippingDetails(부분: shippingRate). status·recordedAt·note는 표준에 없음.",
"properties": {
"shippingRate": {
"$ref": "#/$defs/MonetaryAmount"
},
"status": {
"enum": [
"known",
"free",
"unknown"
],
"title": "Status",
"type": "string"
},
"recordedAt": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recordedat"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Note"
}
},
"required": [
"shippingRate",
"status"
],
"title": "ShippingDetails",
"type": "object"
}
},
"additionalProperties": false,
"title": "FolsnProductOfferOut"
}🟢search_beauty_products(query, skin_type, exclude_ingredients, functional_type, limit)
대한민국 화장품/뷰티 표준 상품을 검색합니다. 바코드(880), 브랜드, 상품명으로 검색하며, 피부타입(건성/지성/민감성), 제외할 특정 성분(exclude_ingredients), 기능성(미백/주름개선/자외선차단) 필터링을 지원합니다. 예: {"query": "독도 토너", "skin_type": "민감성", "exclude_ingredients": "향료,페녹시에탄올"} Search canonical cosmetics/beauty products in Korea by barcode, brand, or name with skin type, excluded ingredients, and functional type filtering.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"description": "화장품 상품명, 브랜드, 또는 바코드(880) / product name, brand or barcode",
"examples": [
"독도 토너",
"8809514550019"
],
"maxLength": 100,
"minLength": 1,
"title": "Query",
"type": "string"
},
"skin_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "피부타입 필터 (민감성, 건성, 지성) / skin type filter (sensitive, dry, oily)",
"examples": [
"민감성"
],
"title": "Skin Type"
},
"exclude_ingredients": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "제외할 성분 목록 (콤마 구분) / comma-separated ingredients to exclude",
"examples": [
"향료,페녹시에탄올"
],
"title": "Exclude Ingredients"
},
"functional_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "기능성화장품 종류 (미백, 주름개선, 자외선차단) / functional cosmetic type",
"examples": [
"자외선차단"
],
"title": "Functional Type"
},
"limit": {
"default": 10,
"description": "최대 결과 수 (1~20) / max results",
"maximum": 20,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"query"
],
"title": "search_beauty_productsArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"totalCount": {
"title": "Totalcount",
"type": "integer"
},
"products": {
"items": {
"$ref": "#/$defs/BeautyProductItem"
},
"title": "Products",
"type": "array"
},
"notice": {
"default": "대한민국 화장품/뷰티 기준 원장 검색 결과입니다.",
"title": "Notice",
"type": "string"
}
},
"required": [
"query",
"totalCount"
],
"$defs": {
"BeautyProductItem": {
"properties": {
"beautyId": {
"title": "Beautyid",
"type": "string"
},
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Barcode"
},
"brandName": {
"title": "Brandname",
"type": "string"
},
"productName": {
"title": "Productname",
"type": "string"
},
"categoryLarge": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Categorylarge"
},
"categoryMid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Categorymid"
},
"categorySmall": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Categorysmall"
},
"formulation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Formulation"
},
"capacityAmount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Capacityamount"
},
"capacityUnit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "ml",
"title": "Capacityunit"
},
"standardUnitType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "10ml",
"title": "Standardunittype"
},
"functionalTypes": {
"items": {
"type": "string"
},
"title": "Functionaltypes",
"type": "array"
},
"approvalNo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Approvalno"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Manufacturer"
},
"distributor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Distributor"
},
"imageUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Imageurl"
},
"minOfferPrice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Minofferprice"
},
"minUnitPrice10ml": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Minunitprice10Ml"
},
"attributes": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Attributes"
},
"sensoryReviews": {
"items": {
"$ref": "#/$defs/BeautySensoryReviewItem"
},
"title": "Sensoryreviews",
"type": "array"
}
},
"required": [
"beautyId",
"brandName",
"productName"
],
"title": "BeautyProductItem",
"type": "object"
},
"BeautySensoryReviewItem": {
"description": "2단계: 사용자 체감 제형·향·만족도 및 리뷰 요약 메타.",
"properties": {
"sensoryType": {
"title": "Sensorytype",
"type": "string"
},
"primaryTag": {
"title": "Primarytag",
"type": "string"
},
"positiveRatio": {
"default": 1,
"title": "Positiveratio",
"type": "number"
},
"reviewCount": {
"default": 0,
"title": "Reviewcount",
"type": "integer"
},
"summaryPoints": {
"items": {
"type": "string"
},
"title": "Summarypoints",
"type": "array"
},
"suitabilityAdvice": {
"additionalProperties": {
"type": "string"
},
"title": "Suitabilityadvice",
"type": "object"
}
},
"required": [
"sensoryType",
"primaryTag"
],
"title": "BeautySensoryReviewItem",
"type": "object"
}
},
"title": "SearchBeautyProductsOut"
}🟢get_beauty_product_detail(barcode, beauty_id, product_name)
화장품의 식약처 인허가 정보, 용량, 제형, 제조사, 책임판매업자 및 전성분 목록(EWG 등급, 20가지 주의성분, 25종 알레르기 유발성분 표시)을 조회합니다. 예: {"barcode": "8809514550019"} 또는 {"beauty_id": "BP_8809514550019"} Get canonical cosmetics master details, MFDS approval, and full ingredients list with EWG scores, 20 caution ingredients, and 25 allergens.
Eingabe-Schema
{
"type": "object",
"properties": {
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "880 바코드(GTIN-13) / 880 barcode",
"examples": [
"8809514550019"
],
"title": "Barcode"
},
"beauty_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "화장품 고유 ID (BP_...) / unique beauty ID",
"examples": [
"BP_8809514550019"
],
"title": "Beauty Id"
},
"product_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "상품명 검색어 / product name",
"examples": [
"라운드랩 독도 토너"
],
"title": "Product Name"
}
},
"title": "get_beauty_product_detailArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"$ref": "#/$defs/BeautyProductItem"
},
{
"type": "null"
}
],
"default": null
},
"ingredients": {
"items": {
"$ref": "#/$defs/BeautyIngredientItem"
},
"title": "Ingredients",
"type": "array"
},
"safetyRecall": {
"anyOf": [
{
"$ref": "#/$defs/BeautyRecallItem"
},
{
"type": "null"
}
],
"default": null
},
"sensoryReviews": {
"items": {
"$ref": "#/$defs/BeautySensoryReviewItem"
},
"title": "Sensoryreviews",
"type": "array"
},
"notice": {
"default": "식약처 인허가 및 전성분 기준 상세 정보입니다.",
"title": "Notice",
"type": "string"
}
},
"$defs": {
"BeautyIngredientItem": {
"properties": {
"ingredientSeq": {
"title": "Ingredientseq",
"type": "integer"
},
"nameKo": {
"title": "Nameko",
"type": "string"
},
"nameEn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Nameen"
},
"ewgScore": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Ewgscore"
},
"ewgGrade": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Ewggrade"
},
"isCaution20": {
"default": false,
"title": "Iscaution20",
"type": "boolean"
},
"isAllergy25": {
"default": false,
"title": "Isallergy25",
"type": "boolean"
},
"purpose": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Purpose"
}
},
"required": [
"ingredientSeq",
"nameKo"
],
"title": "BeautyIngredientItem",
"type": "object"
},
"BeautyProductItem": {
"properties": {
"beautyId": {
"title": "Beautyid",
"type": "string"
},
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Barcode"
},
"brandName": {
"title": "Brandname",
"type": "string"
},
"productName": {
"title": "Productname",
"type": "string"
},
"categoryLarge": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Categorylarge"
},
"categoryMid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Categorymid"
},
"categorySmall": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Categorysmall"
},
"formulation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Formulation"
},
"capacityAmount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Capacityamount"
},
"capacityUnit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "ml",
"title": "Capacityunit"
},
"standardUnitType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "10ml",
"title": "Standardunittype"
},
"functionalTypes": {
"items": {
"type": "string"
},
"title": "Functionaltypes",
"type": "array"
},
"approvalNo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Approvalno"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Manufacturer"
},
"distributor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Distributor"
},
"imageUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Imageurl"
},
"minOfferPrice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Minofferprice"
},
"minUnitPrice10ml": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Minunitprice10Ml"
},
"attributes": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Attributes"
},
"sensoryReviews": {
"items": {
"$ref": "#/$defs/BeautySensoryReviewItem"
},
"title": "Sensoryreviews",
"type": "array"
}
},
"required": [
"beautyId",
"brandName",
"productName"
],
"title": "BeautyProductItem",
"type": "object"
},
"BeautyRecallItem": {
"properties": {
"recallId": {
"title": "Recallid",
"type": "string"
},
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Barcode"
},
"productName": {
"title": "Productname",
"type": "string"
},
"categoryLarge": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Categorylarge"
},
"agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "식약처",
"title": "Agency"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Manufacturer"
},
"reason": {
"title": "Reason",
"type": "string"
},
"actionDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Actiondate"
}
},
"required": [
"recallId",
"productName",
"reason"
],
"title": "BeautyRecallItem",
"type": "object"
},
"BeautySensoryReviewItem": {
"description": "2단계: 사용자 체감 제형·향·만족도 및 리뷰 요약 메타.",
"properties": {
"sensoryType": {
"title": "Sensorytype",
"type": "string"
},
"primaryTag": {
"title": "Primarytag",
"type": "string"
},
"positiveRatio": {
"default": 1,
"title": "Positiveratio",
"type": "number"
},
"reviewCount": {
"default": 0,
"title": "Reviewcount",
"type": "integer"
},
"summaryPoints": {
"items": {
"type": "string"
},
"title": "Summarypoints",
"type": "array"
},
"suitabilityAdvice": {
"additionalProperties": {
"type": "string"
},
"title": "Suitabilityadvice",
"type": "object"
}
},
"required": [
"sensoryType",
"primaryTag"
],
"title": "BeautySensoryReviewItem",
"type": "object"
}
},
"title": "GetBeautyDetailOut"
}🟢compare_beauty_offers(beauty_id, barcode)
올리브영, 화해, 쿠팡, 백화점몰 등 전 채널의 실시간 판매가, 배송비, 쿠폰가 및 10ml(또는 10g)당 단위가격을 비교하여 최저가 순으로 정렬합니다. 단품, 묶음(1+1 등), 리필을 구분합니다. 예: {"beauty_id": "BP_8809514550019"} 또는 {"barcode": "8809514550019"} Compare live offers across 50+ channels (Olive Young, Hwahae, Coupang, Department stores) with 10ml unit prices and bundle/refill distinctions.
Eingabe-Schema
{
"type": "object",
"properties": {
"beauty_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "화장품 고유 ID (BP_...) / unique beauty ID",
"examples": [
"BP_8809514550019"
],
"title": "Beauty Id"
},
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "880 바코드 / 880 barcode",
"examples": [
"8809514550019"
],
"title": "Barcode"
}
},
"title": "compare_beauty_offersArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"beautyId": {
"title": "Beautyid",
"type": "string"
},
"productName": {
"title": "Productname",
"type": "string"
},
"capacity": {
"title": "Capacity",
"type": "string"
},
"lowestEffectivePrice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Lowesteffectiveprice"
},
"lowestUnitPrice10ml": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lowestunitprice10Ml"
},
"offers": {
"items": {
"$ref": "#/$defs/BeautyOfferItem"
},
"title": "Offers",
"type": "array"
},
"notice": {
"default": "전 채널 실시간 오퍼 및 10ml당 환산 단위가격 비교 결과입니다.",
"title": "Notice",
"type": "string"
}
},
"required": [
"beautyId",
"productName",
"capacity"
],
"$defs": {
"BeautyOfferItem": {
"properties": {
"offerId": {
"title": "Offerid",
"type": "string"
},
"beautyId": {
"title": "Beautyid",
"type": "string"
},
"mallCode": {
"title": "Mallcode",
"type": "string"
},
"mallName": {
"title": "Mallname",
"type": "string"
},
"salePrice": {
"title": "Saleprice",
"type": "integer"
},
"deliveryFee": {
"title": "Deliveryfee",
"type": "integer"
},
"couponPrice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Couponprice"
},
"effectivePrice": {
"title": "Effectiveprice",
"type": "integer"
},
"unitPrice10ml": {
"title": "Unitprice10Ml",
"type": "number"
},
"bundleCount": {
"default": 1,
"title": "Bundlecount",
"type": "integer"
},
"isRefill": {
"default": false,
"title": "Isrefill",
"type": "boolean"
},
"directUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Directurl"
},
"inStock": {
"default": true,
"title": "Instock",
"type": "boolean"
},
"updatedAt": {
"title": "Updatedat",
"type": "string"
}
},
"required": [
"offerId",
"beautyId",
"mallCode",
"mallName",
"salePrice",
"deliveryFee",
"effectivePrice",
"unitPrice10ml",
"updatedAt"
],
"title": "BeautyOfferItem",
"type": "object"
}
},
"title": "CompareBeautyOffersOut"
}🟢analyze_ingredients(product_name_or_id, ingredients_text)
화장품 전성분의 안전도를 심층 분석합니다. 20가지 주의성분, 25종 식약처 알레르기 유발성분, EWG 위험 등급 분포 및 피부타입별(건성/지성/민감성) 주의사항을 도출합니다. 예: {"product_name_or_id": "설화수 윤조에센스"} 또는 {"ingredients_text": "정제수, 글리세린, 페녹시에탄올, 향료"} In-depth analysis of cosmetic ingredients for 20 caution ingredients, 25 MFDS allergens, EWG distribution, and skin type suitability.
Eingabe-Schema
{
"type": "object",
"properties": {
"product_name_or_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "상품명 또는 beauty_id / product name or beauty_id",
"examples": [
"설화수 윤조에센스",
"BP_8809514550019"
],
"title": "Product Name Or Id"
},
"ingredients_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "전성분 텍스트 (콤마 구분) / comma-separated ingredients text",
"examples": [
"정제수, 글리세린, 페녹시에탄올, 향료"
],
"title": "Ingredients Text"
}
},
"title": "analyze_ingredientsArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"productName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Productname"
},
"summary": {
"$ref": "#/$defs/IngredientCautionSummary"
},
"analyzedIngredients": {
"items": {
"$ref": "#/$defs/BeautyIngredientItem"
},
"title": "Analyzedingredients",
"type": "array"
},
"sensoryReviews": {
"items": {
"$ref": "#/$defs/BeautySensoryReviewItem"
},
"title": "Sensoryreviews",
"type": "array"
},
"notice": {
"default": "화해 20가지 주의성분 및 식약처 25종 알레르기 유발성분 심층 분석 결과입니다.",
"title": "Notice",
"type": "string"
}
},
"required": [
"summary"
],
"$defs": {
"BeautyIngredientItem": {
"properties": {
"ingredientSeq": {
"title": "Ingredientseq",
"type": "integer"
},
"nameKo": {
"title": "Nameko",
"type": "string"
},
"nameEn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Nameen"
},
"ewgScore": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Ewgscore"
},
"ewgGrade": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Ewggrade"
},
"isCaution20": {
"default": false,
"title": "Iscaution20",
"type": "boolean"
},
"isAllergy25": {
"default": false,
"title": "Isallergy25",
"type": "boolean"
},
"purpose": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Purpose"
}
},
"required": [
"ingredientSeq",
"nameKo"
],
"title": "BeautyIngredientItem",
"type": "object"
},
"BeautySensoryReviewItem": {
"description": "2단계: 사용자 체감 제형·향·만족도 및 리뷰 요약 메타.",
"properties": {
"sensoryType": {
"title": "Sensorytype",
"type": "string"
},
"primaryTag": {
"title": "Primarytag",
"type": "string"
},
"positiveRatio": {
"default": 1,
"title": "Positiveratio",
"type": "number"
},
"reviewCount": {
"default": 0,
"title": "Reviewcount",
"type": "integer"
},
"summaryPoints": {
"items": {
"type": "string"
},
"title": "Summarypoints",
"type": "array"
},
"suitabilityAdvice": {
"additionalProperties": {
"type": "string"
},
"title": "Suitabilityadvice",
"type": "object"
}
},
"required": [
"sensoryType",
"primaryTag"
],
"title": "BeautySensoryReviewItem",
"type": "object"
},
"IngredientCautionSummary": {
"properties": {
"totalIngredientCount": {
"title": "Totalingredientcount",
"type": "integer"
},
"caution20Count": {
"title": "Caution20Count",
"type": "integer"
},
"caution20List": {
"items": {
"type": "string"
},
"title": "Caution20List",
"type": "array"
},
"allergy25Count": {
"title": "Allergy25Count",
"type": "integer"
},
"allergy25List": {
"items": {
"type": "string"
},
"title": "Allergy25List",
"type": "array"
},
"ewgGradeDistribution": {
"additionalProperties": {
"type": "integer"
},
"title": "Ewggradedistribution",
"type": "object"
},
"skinTypeAdvice": {
"additionalProperties": {
"type": "string"
},
"title": "Skintypeadvice",
"type": "object"
}
},
"required": [
"totalIngredientCount",
"caution20Count",
"allergy25Count"
],
"title": "IngredientCautionSummary",
"type": "object"
}
},
"title": "AnalyzeIngredientsOut"
}🟢verify_cosmetic_safety(barcode_or_name)
식약처 의약품안전나라 회수·폐기·판매중지 행정처분 이력을 실시간 대조하여 해당 상품의 안전성을 검증합니다. 예: {"barcode_or_name": "8809514550019"} 또는 {"barcode_or_name": "독도 토너"} Verify product safety by checking MFDS cosmetic administrative recall and ban records in real time.
Eingabe-Schema
{
"type": "object",
"properties": {
"barcode_or_name": {
"description": "바코드(880) 또는 화장품 상품명 / barcode or cosmetic product name",
"examples": [
"8809514550019",
"독도 토너"
],
"maxLength": 100,
"minLength": 1,
"title": "Barcode Or Name",
"type": "string"
}
},
"required": [
"barcode_or_name"
],
"title": "verify_cosmetic_safetyArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"isRegisteredApproved": {
"title": "Isregisteredapproved",
"type": "boolean"
},
"isRecalled": {
"title": "Isrecalled",
"type": "boolean"
},
"approvalNo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Approvalno"
},
"recallInfo": {
"anyOf": [
{
"$ref": "#/$defs/BeautyRecallItem"
},
{
"type": "null"
}
],
"default": null
},
"verdict": {
"title": "Verdict",
"type": "string"
},
"notice": {
"default": "식약처 의약품안전나라 및 위해 회수 데이터 실시간 대조 검증 결과입니다.",
"title": "Notice",
"type": "string"
}
},
"required": [
"query",
"isRegisteredApproved",
"isRecalled",
"verdict"
],
"$defs": {
"BeautyRecallItem": {
"properties": {
"recallId": {
"title": "Recallid",
"type": "string"
},
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Barcode"
},
"productName": {
"title": "Productname",
"type": "string"
},
"categoryLarge": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Categorylarge"
},
"agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "식약처",
"title": "Agency"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Manufacturer"
},
"reason": {
"title": "Reason",
"type": "string"
},
"actionDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Actiondate"
}
},
"required": [
"recallId",
"productName",
"reason"
],
"title": "BeautyRecallItem",
"type": "object"
}
},
"title": "VerifySafetyOut"
}Community
Nachweis