Folsn Own-Store 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. 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}

{
  "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"
}

{
  "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"
}

검색 결과의 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"}

{
  "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"
}

{
  "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"
}

대한민국 화장품/뷰티 표준 상품을 검색합니다. 바코드(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.

{
  "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"
}

{
  "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"
}

화장품의 식약처 인허가 정보, 용량, 제형, 제조사, 책임판매업자 및 전성분 목록(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.

{
  "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"
}

{
  "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"
}

올리브영, 화해, 쿠팡, 백화점몰 등 전 채널의 실시간 판매가, 배송비, 쿠폰가 및 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.

{
  "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"
}

{
  "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"
}

화장품 전성분의 안전도를 심층 분석합니다. 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.

{
  "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"
}

{
  "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"
}

식약처 의약품안전나라 회수·폐기·판매중지 행정처분 이력을 실시간 대조하여 해당 상품의 안전성을 검증합니다. 예: {"barcode_or_name": "8809514550019"} 또는 {"barcode_or_name": "독도 토너"} Verify product safety by checking MFDS cosmetic administrative recall and ban records in real time.

{
  "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"
}

{
  "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"
}