Folsn Own-Store Products MCP
An MCP server that allows agents to search for products in Folsn's own-store catalog using names, brands, models, or barcodes. It retrieves master processed information, recorded KRW prices, options, shipping details, and purchase URLs. The server is read-only, free, and requires no login, providing tools to verify cosmetic safety and compare offers based on recorded data.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://mcp.folsn.com/public/mcpWhat you can do with it
- Search for product candidates by name, brand, model, or barcode
- Retrieve master processed information and recorded prices
- Check shipping details and purchase URLs for products
- Verify cosmetic safety and compare product offers
Source and maintenance
Vendor evidenceRegistry 0.1.0
Protocol and capabilities
- Server
- folsn-public-products 0.2.0
- MCP protocol
- 2025-06-18
- Tools
- 10 advertised
- Resources
- 0 advertised
- Resource templates
- 0 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
},
"experimental": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
10 advertised
search_folsn_products — 폴슨 상품 검색 / Search Folsn products
Advertised read-only
폴슨(folsn)이 네이버 스마트스토어에서 직접 파는 상품을 상품 이름·옵션(용량·수량·색상·모델 번호)으로 찾습니다. 결과마다 판매가(원)·배송비·묶음 수량과 개당 환산가·재고 상태·구매 주소·가격 기록 시각·출처를 따로 돌려줍니다. 다른 쇼핑몰 가격이나 전체 최저가는 돌려주지 않습니다. 검색어는 한국어 상품명(브랜드 + 제품명 + 용량·수량)이 가장 잘 맞고, 등록된 영어 브랜드·상품명도 일부 지원합니다. matchStatus=needs_clarification이면 clarificationFields의 옵션을 사용자에게 되물으세요. 결과가 없으면 hint의 내용을 사용자에게 전해 주세요. 예: {"query": "쿤달 칫솔 16입", "limit": 5} Search products sold directly by Folsn on its own Naver Smart Store (Korea) by product name and option (volume, count, color, model number). Each result returns price in KRW, shipping fee, bundle quantity with unit price, stock status, purchase URL, the time the price was recorded, and the source as separate fields. It does not return other stores' prices or market-wide lowest prices. Korean product names (brand + product + volume/count) match best; selected English brand and product names also work. Unknown English words remain unchanged. If matchStatus=needs_clarification, ask the user about the options in clarificationFields. If there are no results, relay the hint to the user. Example: {"query": "클로란 피오니 샴푸 400ml", "limit": 5}
search_folsn_products input schema
{
"type": "object",
"title": "search_folsn_productsArguments",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 5,
"maximum": 10,
"minimum": 1,
"examples": [
5
],
"description": "최대 결과 수(1~10) / max results"
},
"query": {
"type": "string",
"title": "Query",
"examples": [
"쿤달 칫솔 16입",
"클로란 피오니 샴푸 400ml"
],
"maxLength": 100,
"minLength": 1,
"description": "상품 이름·옵션 검색어 또는 sku / product name and options, or sku"
}
}
}search_folsn_products output schema
{
"type": "object",
"$defs": {
"Seller": {
"type": "object",
"title": "Seller",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"platform": {
"type": "string",
"const": "네이버 스마트스토어",
"title": "Platform",
"default": "네이버 스마트스토어"
}
},
"description": "schema.org seller(Organization)의 name. platform은 표준에 없음.",
"additionalProperties": false
},
"BundleInfo": {
"type": "object",
"title": "BundleInfo",
"required": [
"status"
],
"properties": {
"basis": {
"type": "string",
"title": "Basis",
"default": "판매가 ÷ 수량(배송비 제외, 원 미만 반올림) / price ÷ quantity, shipping excluded"
},
"status": {
"enum": [
"known",
"unknown",
"ambiguous"
],
"type": "string",
"title": "Status"
},
"tokens": {
"type": "array",
"items": {
"type": "string"
},
"title": "Tokens"
},
"quantity": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"title": "Quantity",
"default": null
},
"unitText": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Unittext",
"default": null
},
"unitPrice": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Unitprice",
"default": null
},
"recordedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Recordedat",
"default": null
}
},
"description": "묶음 수량과 개당 환산가(표준에 없음. schema.org UnitPriceSpecification·eligibleQuantity에 가깝다).",
"additionalProperties": false
},
"CouponInfo": {
"type": "object",
"title": "CouponInfo",
"properties": {
"value": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Value",
"default": null
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Condition",
"default": null
},
"recordedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Recordedat",
"default": null
}
},
"description": "쿠폰(표준에 없음). v0은 쿠폰을 수집하지 않아 항상 coupon=null로 나간다.",
"additionalProperties": false
},
"FolsnOffer": {
"type": "object",
"title": "FolsnOffer",
"required": [
"name",
"sku",
"options",
"priceStatus",
"shippingDetails",
"bundle",
"availabilityStatus",
"seller",
"pricePosition",
"source"
],
"properties": {
"sku": {
"type": "string",
"title": "Sku"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"name": {
"type": "string",
"title": "Name"
},
"price": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Price",
"default": null
},
"bundle": {
"$ref": "#/$defs/BundleInfo"
},
"coupon": {
"anyOf": [
{
"$ref": "#/$defs/CouponInfo"
},
{
"type": "null"
}
],
"default": null
},
"seller": {
"$ref": "#/$defs/Seller"
},
"source": {
"$ref": "#/$defs/OfferSource"
},
"options": {
"$ref": "#/$defs/OptionTokens"
},
"priceStatus": {
"enum": [
"known",
"unknown",
"stale"
],
"type": "string",
"title": "Pricestatus"
},
"availability": {
"anyOf": [
{
"enum": [
"https://schema.org/InStock",
"https://schema.org/OutOfStock",
"https://schema.org/Discontinued"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Availability",
"default": null
},
"priceCurrency": {
"type": "string",
"const": "KRW",
"title": "Pricecurrency",
"default": "KRW"
},
"pricePosition": {
"$ref": "#/$defs/PricePosition"
},
"compositionKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Compositionkey",
"default": null
},
"priceTimeBasis": {
"anyOf": [
{
"enum": [
"store_record_update",
"master_row_update",
"catalog_row_update"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Pricetimebasis",
"default": null
},
"priceRecordedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Pricerecordedat",
"default": null
},
"shippingDetails": {
"$ref": "#/$defs/ShippingDetails"
},
"availabilityStatus": {
"enum": [
"in_stock",
"out_of_stock",
"not_for_sale",
"unknown"
],
"type": "string",
"title": "Availabilitystatus"
}
},
"description": "폴슨 상품 한 건의 판매 조건(schema.org Offer 기준).",
"additionalProperties": false
},
"OfferSource": {
"type": "object",
"title": "OfferSource",
"properties": {
"note": {
"type": "string",
"title": "Note",
"default": "폴슨이 직접 판매하는 상품의 자체 기록입니다. 다른 쇼핑몰 가격은 포함하지 않습니다. / Folsn's own store records only; no other stores' prices."
},
"dataScope": {
"type": "string",
"const": "folsn_own_products",
"title": "Datascope",
"default": "folsn_own_products"
},
"priceRecord": {
"anyOf": [
{
"enum": [
"smartstore_sale_record",
"store_master_record",
"catalog_row_update"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Pricerecord",
"default": null
}
},
"description": "출처(표준에 없음). 공개판은 폴슨 자사 상품 기록만 쓴다.",
"additionalProperties": false
},
"OptionTokens": {
"type": "object",
"title": "OptionTokens",
"properties": {
"colors": {
"type": "array",
"items": {
"type": "string"
},
"title": "Colors"
},
"capacities": {
"type": "array",
"items": {
"type": "string"
},
"title": "Capacities"
},
"packCounts": {
"type": "array",
"items": {
"type": "string"
},
"title": "Packcounts"
},
"modelNumbers": {
"type": "array",
"items": {
"type": "string"
},
"title": "Modelnumbers"
}
},
"description": "상품 이름에 적힌 옵션 토큰(표준에 없음. schema.org additionalProperty에 가깝다).",
"additionalProperties": false
},
"PricePosition": {
"type": "object",
"title": "PricePosition",
"required": [
"status"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null
},
"basis": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Basis",
"default": null
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Label",
"default": null
},
"reason": {
"anyOf": [
{
"enum": [
"not_provided",
"no_basis",
"no_own_total",
"stale_basis",
"own_record_time_mismatch",
"inconsistent"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason",
"default": null
},
"status": {
"enum": [
"matches_lowest",
"higher",
"unknown"
],
"type": "string",
"title": "Status"
},
"recordedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Recordedat",
"default": null
},
"sourceType": {
"anyOf": [
{
"type": "string",
"const": "price_comparison_observation"
},
{
"type": "null"
}
],
"title": "Sourcetype",
"default": null
},
"percentBand": {
"anyOf": [
{
"enum": [
"1-5",
"5-10",
"10-20",
"20-50"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Percentband",
"default": null
}
},
"description": "폴슨 가격의 상대 위치만 담습니다(같음·구간·모름). 금액·판매처·출처는 없습니다. / Relative position of Folsn's delivered price only; no amounts, sellers or sources.",
"additionalProperties": false
},
"MonetaryAmount": {
"type": "object",
"title": "MonetaryAmount",
"properties": {
"value": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Value",
"default": null
},
"currency": {
"type": "string",
"const": "KRW",
"title": "Currency",
"default": "KRW"
}
},
"description": "schema.org MonetaryAmount(부분). value=None이면 모른다는 뜻(0원이 아니다).",
"additionalProperties": false
},
"ShippingDetails": {
"type": "object",
"title": "ShippingDetails",
"required": [
"shippingRate",
"status"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null
},
"status": {
"enum": [
"known",
"free",
"unknown"
],
"type": "string",
"title": "Status"
},
"recordedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Recordedat",
"default": null
},
"shippingRate": {
"$ref": "#/$defs/MonetaryAmount"
}
},
"description": "schema.org OfferShippingDetails(부분: shippingRate). status·recordedAt·note는 표준에 없음.",
"additionalProperties": false
}
},
"title": "SearchFolsnProductsOut",
"required": [
"query",
"matchStatus",
"resultCount"
],
"properties": {
"hint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Hint",
"default": null
},
"query": {
"type": "string",
"title": "Query"
},
"notice": {
"type": "string",
"title": "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."
},
"results": {
"type": "array",
"items": {
"$ref": "#/$defs/FolsnOffer"
},
"title": "Results"
},
"matchStatus": {
"enum": [
"exact",
"candidate",
"needs_clarification",
"no_match"
],
"type": "string",
"title": "Matchstatus"
},
"resultCount": {
"type": "integer",
"title": "Resultcount"
},
"relatedResults": {
"type": "array",
"items": {
"$ref": "#/$defs/FolsnOffer"
},
"title": "Relatedresults"
},
"clarificationFields": {
"type": "array",
"items": {
"type": "string"
},
"title": "Clarificationfields"
}
},
"additionalProperties": false
}search_folsn_products annotations
{
"title": "폴슨 상품 검색 / Search Folsn products",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_folsn_product_offer — 폴슨 상품 판매 조건 / Get Folsn product offer
Advertised read-only
검색 결과의 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"}
get_folsn_product_offer input schema
{
"type": "object",
"title": "get_folsn_product_offerArguments",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"title": "Product Id",
"pattern": "^[0-9A-Za-z_-]+$",
"examples": [
"13300090680"
],
"maxLength": 64,
"minLength": 1,
"description": "검색 결과의 sku(스마트스토어 상품 번호) / sku from search_folsn_products"
}
}
}get_folsn_product_offer output schema
{
"type": "object",
"$defs": {
"Seller": {
"type": "object",
"title": "Seller",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"platform": {
"type": "string",
"const": "네이버 스마트스토어",
"title": "Platform",
"default": "네이버 스마트스토어"
}
},
"description": "schema.org seller(Organization)의 name. platform은 표준에 없음.",
"additionalProperties": false
},
"BundleInfo": {
"type": "object",
"title": "BundleInfo",
"required": [
"status"
],
"properties": {
"basis": {
"type": "string",
"title": "Basis",
"default": "판매가 ÷ 수량(배송비 제외, 원 미만 반올림) / price ÷ quantity, shipping excluded"
},
"status": {
"enum": [
"known",
"unknown",
"ambiguous"
],
"type": "string",
"title": "Status"
},
"tokens": {
"type": "array",
"items": {
"type": "string"
},
"title": "Tokens"
},
"quantity": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"title": "Quantity",
"default": null
},
"unitText": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Unittext",
"default": null
},
"unitPrice": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Unitprice",
"default": null
},
"recordedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Recordedat",
"default": null
}
},
"description": "묶음 수량과 개당 환산가(표준에 없음. schema.org UnitPriceSpecification·eligibleQuantity에 가깝다).",
"additionalProperties": false
},
"CouponInfo": {
"type": "object",
"title": "CouponInfo",
"properties": {
"value": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Value",
"default": null
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Condition",
"default": null
},
"recordedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Recordedat",
"default": null
}
},
"description": "쿠폰(표준에 없음). v0은 쿠폰을 수집하지 않아 항상 coupon=null로 나간다.",
"additionalProperties": false
},
"FolsnOffer": {
"type": "object",
"title": "FolsnOffer",
"required": [
"name",
"sku",
"options",
"priceStatus",
"shippingDetails",
"bundle",
"availabilityStatus",
"seller",
"pricePosition",
"source"
],
"properties": {
"sku": {
"type": "string",
"title": "Sku"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"name": {
"type": "string",
"title": "Name"
},
"price": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Price",
"default": null
},
"bundle": {
"$ref": "#/$defs/BundleInfo"
},
"coupon": {
"anyOf": [
{
"$ref": "#/$defs/CouponInfo"
},
{
"type": "null"
}
],
"default": null
},
"seller": {
"$ref": "#/$defs/Seller"
},
"source": {
"$ref": "#/$defs/OfferSource"
},
"options": {
"$ref": "#/$defs/OptionTokens"
},
"priceStatus": {
"enum": [
"known",
"unknown",
"stale"
],
"type": "string",
"title": "Pricestatus"
},
"availability": {
"anyOf": [
{
"enum": [
"https://schema.org/InStock",
"https://schema.org/OutOfStock",
"https://schema.org/Discontinued"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Availability",
"default": null
},
"priceCurrency": {
"type": "string",
"const": "KRW",
"title": "Pricecurrency",
"default": "KRW"
},
"pricePosition": {
"$ref": "#/$defs/PricePosition"
},
"compositionKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Compositionkey",
"default": null
},
"priceTimeBasis": {
"anyOf": [
{
"enum": [
"store_record_update",
"master_row_update",
"catalog_row_update"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Pricetimebasis",
"default": null
},
"priceRecordedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Pricerecordedat",
"default": null
},
"shippingDetails": {
"$ref": "#/$defs/ShippingDetails"
},
"availabilityStatus": {
"enum": [
"in_stock",
"out_of_stock",
"not_for_sale",
"unknown"
],
"type": "string",
"title": "Availabilitystatus"
}
},
"description": "폴슨 상품 한 건의 판매 조건(schema.org Offer 기준).",
"additionalProperties": false
},
"OfferSource": {
"type": "object",
"title": "OfferSource",
"properties": {
"note": {
"type": "string",
"title": "Note",
"default": "폴슨이 직접 판매하는 상품의 자체 기록입니다. 다른 쇼핑몰 가격은 포함하지 않습니다. / Folsn's own store records only; no other stores' prices."
},
"dataScope": {
"type": "string",
"const": "folsn_own_products",
"title": "Datascope",
"default": "folsn_own_products"
},
"priceRecord": {
"anyOf": [
{
"enum": [
"smartstore_sale_record",
"store_master_record",
"catalog_row_update"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Pricerecord",
"default": null
}
},
"description": "출처(표준에 없음). 공개판은 폴슨 자사 상품 기록만 쓴다.",
"additionalProperties": false
},
"OptionTokens": {
"type": "object",
"title": "OptionTokens",
"properties": {
"colors": {
"type": "array",
"items": {
"type": "string"
},
"title": "Colors"
},
"capacities": {
"type": "array",
"items": {
"type": "string"
},
"title": "Capacities"
},
"packCounts": {
"type": "array",
"items": {
"type": "string"
},
"title": "Packcounts"
},
"modelNumbers": {
"type": "array",
"items": {
"type": "string"
},
"title": "Modelnumbers"
}
},
"description": "상품 이름에 적힌 옵션 토큰(표준에 없음. schema.org additionalProperty에 가깝다).",
"additionalProperties": false
},
"PricePosition": {
"type": "object",
"title": "PricePosition",
"required": [
"status"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null
},
"basis": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Basis",
"default": null
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Label",
"default": null
},
"reason": {
"anyOf": [
{
"enum": [
"not_provided",
"no_basis",
"no_own_total",
"stale_basis",
"own_record_time_mismatch",
"inconsistent"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason",
"default": null
},
"status": {
"enum": [
"matches_lowest",
"higher",
"unknown"
],
"type": "string",
"title": "Status"
},
"recordedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Recordedat",
"default": null
},
"sourceType": {
"anyOf": [
{
"type": "string",
"const": "price_comparison_observation"
},
{
"type": "null"
}
],
"title": "Sourcetype",
"default": null
},
"percentBand": {
"anyOf": [
{
"enum": [
"1-5",
"5-10",
"10-20",
"20-50"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Percentband",
"default": null
}
},
"description": "폴슨 가격의 상대 위치만 담습니다(같음·구간·모름). 금액·판매처·출처는 없습니다. / Relative position of Folsn's delivered price only; no amounts, sellers or sources.",
"additionalProperties": false
},
"MonetaryAmount": {
"type": "object",
"title": "MonetaryAmount",
"properties": {
"value": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Value",
"default": null
},
"currency": {
"type": "string",
"const": "KRW",
"title": "Currency",
"default": "KRW"
}
},
"description": "schema.org MonetaryAmount(부분). value=None이면 모른다는 뜻(0원이 아니다).",
"additionalProperties": false
},
"ShippingDetails": {
"type": "object",
"title": "ShippingDetails",
"required": [
"shippingRate",
"status"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null
},
"status": {
"enum": [
"known",
"free",
"unknown"
],
"type": "string",
"title": "Status"
},
"recordedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Recordedat",
"default": null
},
"shippingRate": {
"$ref": "#/$defs/MonetaryAmount"
}
},
"description": "schema.org OfferShippingDetails(부분: shippingRate). status·recordedAt·note는 표준에 없음.",
"additionalProperties": false
}
},
"title": "FolsnProductOfferOut",
"required": [
"productId",
"matchStatus"
],
"properties": {
"notice": {
"type": "string",
"title": "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."
},
"offers": {
"type": "array",
"items": {
"$ref": "#/$defs/FolsnOffer"
},
"title": "Offers"
},
"productId": {
"type": "string",
"title": "Productid"
},
"matchStatus": {
"enum": [
"found",
"not_found",
"multiple"
],
"type": "string",
"title": "Matchstatus"
}
},
"additionalProperties": false
}get_folsn_product_offer annotations
{
"title": "폴슨 상품 판매 조건 / Get Folsn product offer",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_catalog_products — 전체 상품 원장 검색 / Search catalog products
Advertised read-only
보유 원장별 상품 후보를 이름·브랜드·모델·바코드로 찾습니다. 미검증 가공 필드는 상태로 표시하고 가격은 내지 않습니다. Search recorded catalog candidates across product sources; no price in search.
search_catalog_products input schema
{
"type": "object",
"title": "search_catalog_productsArguments",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 5,
"maximum": 10,
"minimum": 1
},
"query": {
"type": "string",
"title": "Query",
"maxLength": 100,
"minLength": 1,
"description": "상품명·브랜드·모델·바코드 / name, brand, model, GTIN"
}
}
}search_catalog_products output schema
{
"type": "object",
"$defs": {
"Variant": {
"type": "object",
"title": "Variant",
"required": [
"variantId",
"status"
],
"properties": {
"status": {
"enum": [
"verified",
"provisional"
],
"type": "string",
"title": "Status"
},
"variantId": {
"type": "string",
"title": "Variantid"
},
"attributes": {
"type": "object",
"title": "Attributes",
"additionalProperties": {
"type": "string"
}
}
},
"additionalProperties": false
},
"Identifier": {
"type": "object",
"title": "Identifier",
"required": [
"type",
"value",
"status"
],
"properties": {
"type": {
"enum": [
"gtin",
"model_no",
"naver_catalog",
"danawa_catalog"
],
"type": "string",
"title": "Type"
},
"value": {
"type": "string",
"title": "Value"
},
"status": {
"enum": [
"verified",
"provisional"
],
"type": "string",
"title": "Status"
}
},
"additionalProperties": false
},
"FieldEvidence": {
"type": "object",
"title": "FieldEvidence",
"required": [
"source",
"verificationStatus"
],
"properties": {
"source": {
"type": "string",
"title": "Source"
},
"recordedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Recordedat",
"default": null
},
"verificationStatus": {
"enum": [
"verified",
"provisional",
"unverified"
],
"type": "string",
"title": "Verificationstatus"
}
},
"additionalProperties": false
},
"CatalogProduct": {
"type": "object",
"title": "CatalogProduct",
"required": [
"productId",
"sourceCatalog",
"identityStatus",
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand",
"default": null
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category",
"default": null
},
"variants": {
"type": "array",
"items": {
"$ref": "#/$defs/Variant"
},
"title": "Variants"
},
"productId": {
"type": "string",
"title": "Productid"
},
"updatedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Updatedat",
"default": null
},
"identifiers": {
"type": "array",
"items": {
"$ref": "#/$defs/Identifier"
},
"title": "Identifiers"
},
"ingredients": {
"type": "array",
"items": {
"type": "string"
},
"title": "Ingredients"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
},
"fieldEvidence": {
"type": "object",
"title": "Fieldevidence",
"additionalProperties": {
"$ref": "#/$defs/FieldEvidence"
}
},
"sourceCatalog": {
"enum": [
"graph",
"own_store",
"universal",
"beauty_legacy"
],
"type": "string",
"title": "Sourcecatalog"
},
"approvalNumber": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Approvalnumber",
"default": null
},
"identityStatus": {
"enum": [
"verified",
"provisional",
"unverified"
],
"type": "string",
"title": "Identitystatus"
},
"specifications": {
"type": "object",
"title": "Specifications",
"additionalProperties": {
"type": "string"
}
},
"functionalClaims": {
"type": "array",
"items": {
"type": "string"
},
"title": "Functionalclaims"
}
},
"additionalProperties": false
}
},
"title": "SearchCatalogProductsOut",
"required": [
"query",
"notice"
],
"properties": {
"query": {
"type": "string",
"title": "Query"
},
"notice": {
"type": "string",
"title": "Notice"
},
"status": {
"enum": [
"complete",
"partial",
"unavailable"
],
"type": "string",
"title": "Status",
"default": "complete"
},
"products": {
"type": "array",
"items": {
"$ref": "#/$defs/CatalogProduct"
},
"title": "Products"
},
"unavailableSources": {
"type": "array",
"items": {
"type": "string"
},
"title": "Unavailablesources"
}
},
"additionalProperties": false
}search_catalog_products annotations
{
"title": "전체 상품 원장 검색 / Search catalog products",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_catalog_product — 상품 마스터 상세 / Get catalog product
Advertised read-only
검색 결과의 productId로 허용된 상품 마스터 필드·출처·검증 상태를 조회합니다. Get whitelisted master fields and evidence for a search result productId.
get_catalog_product input schema
{
"type": "object",
"title": "get_catalog_productArguments",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"title": "Product Id",
"pattern": "^[0-9A-Za-z_-]+$",
"maxLength": 100,
"minLength": 1,
"description": "search_catalog_products의 productId"
}
}
}get_catalog_product output schema
{
"type": "object",
"$defs": {
"Variant": {
"type": "object",
"title": "Variant",
"required": [
"variantId",
"status"
],
"properties": {
"status": {
"enum": [
"verified",
"provisional"
],
"type": "string",
"title": "Status"
},
"variantId": {
"type": "string",
"title": "Variantid"
},
"attributes": {
"type": "object",
"title": "Attributes",
"additionalProperties": {
"type": "string"
}
}
},
"additionalProperties": false
},
"Identifier": {
"type": "object",
"title": "Identifier",
"required": [
"type",
"value",
"status"
],
"properties": {
"type": {
"enum": [
"gtin",
"model_no",
"naver_catalog",
"danawa_catalog"
],
"type": "string",
"title": "Type"
},
"value": {
"type": "string",
"title": "Value"
},
"status": {
"enum": [
"verified",
"provisional"
],
"type": "string",
"title": "Status"
}
},
"additionalProperties": false
},
"FieldEvidence": {
"type": "object",
"title": "FieldEvidence",
"required": [
"source",
"verificationStatus"
],
"properties": {
"source": {
"type": "string",
"title": "Source"
},
"recordedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Recordedat",
"default": null
},
"verificationStatus": {
"enum": [
"verified",
"provisional",
"unverified"
],
"type": "string",
"title": "Verificationstatus"
}
},
"additionalProperties": false
},
"CatalogProduct": {
"type": "object",
"title": "CatalogProduct",
"required": [
"productId",
"sourceCatalog",
"identityStatus",
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand",
"default": null
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category",
"default": null
},
"variants": {
"type": "array",
"items": {
"$ref": "#/$defs/Variant"
},
"title": "Variants"
},
"productId": {
"type": "string",
"title": "Productid"
},
"updatedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Updatedat",
"default": null
},
"identifiers": {
"type": "array",
"items": {
"$ref": "#/$defs/Identifier"
},
"title": "Identifiers"
},
"ingredients": {
"type": "array",
"items": {
"type": "string"
},
"title": "Ingredients"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
},
"fieldEvidence": {
"type": "object",
"title": "Fieldevidence",
"additionalProperties": {
"$ref": "#/$defs/FieldEvidence"
}
},
"sourceCatalog": {
"enum": [
"graph",
"own_store",
"universal",
"beauty_legacy"
],
"type": "string",
"title": "Sourcecatalog"
},
"approvalNumber": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Approvalnumber",
"default": null
},
"identityStatus": {
"enum": [
"verified",
"provisional",
"unverified"
],
"type": "string",
"title": "Identitystatus"
},
"specifications": {
"type": "object",
"title": "Specifications",
"additionalProperties": {
"type": "string"
}
},
"functionalClaims": {
"type": "array",
"items": {
"type": "string"
},
"title": "Functionalclaims"
}
},
"additionalProperties": false
}
},
"title": "GetCatalogProductOut",
"required": [
"notice"
],
"properties": {
"notice": {
"type": "string",
"title": "Notice"
},
"product": {
"anyOf": [
{
"$ref": "#/$defs/CatalogProduct"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
}get_catalog_product annotations
{
"title": "상품 마스터 상세 / Get catalog product",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_catalog_offers — 상품 판매처 관측 / Get catalog offers
Advertised read-only
상품에 확인된 판매처 관측만 반환합니다. 미연결 오퍼·시드 가격을 상품에 임의로 붙이지 않습니다. Recorded linked offers only; unknown shipping and URL remain null.
get_catalog_offers input schema
{
"type": "object",
"title": "get_catalog_offersArguments",
"required": [
"product_id"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"maximum": 20,
"minimum": 1
},
"product_id": {
"type": "string",
"title": "Product Id",
"pattern": "^[0-9A-Za-z_-]+$",
"maxLength": 100,
"minLength": 1,
"description": "search_catalog_products의 productId"
}
}
}get_catalog_offers output schema
{
"type": "object",
"$defs": {
"CatalogOffer": {
"type": "object",
"title": "CatalogOffer",
"required": [
"sellerName",
"source"
],
"properties": {
"source": {
"type": "string",
"title": "Source"
},
"currency": {
"type": "string",
"const": "KRW",
"title": "Currency",
"default": "KRW"
},
"itemPrice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Itemprice",
"default": null
},
"urlStatus": {
"enum": [
"direct_verified",
"unverified",
"missing"
],
"type": "string",
"title": "Urlstatus",
"default": "missing"
},
"variantId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Variantid",
"default": null
},
"observedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Observedat",
"default": null
},
"productUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Producturl",
"default": null
},
"sellerName": {
"type": "string",
"title": "Sellername"
},
"couponPrice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Couponprice",
"default": null
},
"priceStatus": {
"enum": [
"observed",
"unverified",
"unknown"
],
"type": "string",
"title": "Pricestatus",
"default": "unknown"
},
"shippingFee": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Shippingfee",
"default": null
},
"availability": {
"enum": [
"in_stock",
"out_of_stock",
"unknown"
],
"type": "string",
"title": "Availability",
"default": "unknown"
},
"couponStatus": {
"enum": [
"known",
"conditional",
"unknown"
],
"type": "string",
"title": "Couponstatus",
"default": "unknown"
},
"shippingStatus": {
"enum": [
"known",
"conditional",
"unknown"
],
"type": "string",
"title": "Shippingstatus",
"default": "unknown"
},
"couponCondition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Couponcondition",
"default": null
},
"compositionStatus": {
"enum": [
"verified",
"unknown"
],
"type": "string",
"title": "Compositionstatus",
"default": "unknown"
},
"shippingCondition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Shippingcondition",
"default": null
}
},
"additionalProperties": false
}
},
"title": "GetCatalogOffersOut",
"required": [
"productId",
"notice"
],
"properties": {
"notice": {
"type": "string",
"title": "Notice"
},
"offers": {
"type": "array",
"items": {
"$ref": "#/$defs/CatalogOffer"
},
"title": "Offers"
},
"productId": {
"type": "string",
"title": "Productid"
}
},
"additionalProperties": false
}get_catalog_offers annotations
{
"title": "상품 판매처 관측 / Get catalog offers",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_beauty_products — 화장품 표준 상품 검색 / Search beauty products
Advertised read-only
화장품 원장의 출처 미검증 상품 후보를 검색합니다. 인허가·가격·안전성은 보증하지 않습니다. Search cosmetic catalog candidates; approval, prices and safety remain unverified.
search_beauty_products input schema
{
"type": "object",
"title": "search_beauty_productsArguments",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "최대 결과 수 (1~20) / max results"
},
"query": {
"type": "string",
"title": "Query",
"examples": [
"독도 토너",
"8809514550019"
],
"maxLength": 100,
"minLength": 1,
"description": "화장품 상품명, 브랜드, 또는 바코드(880) / product name, brand or barcode"
},
"skin_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Skin Type",
"default": null,
"examples": [
"민감성"
],
"description": "피부타입 필터 (민감성, 건성, 지성) / skin type filter (sensitive, dry, oily)"
},
"functional_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Functional Type",
"default": null,
"examples": [
"자외선차단"
],
"description": "기능성화장품 종류 (미백, 주름개선, 자외선차단) / functional cosmetic type"
},
"exclude_ingredients": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Exclude Ingredients",
"default": null,
"examples": [
"향료,페녹시에탄올"
],
"description": "제외할 성분 목록 (콤마 구분) / comma-separated ingredients to exclude"
}
}
}search_beauty_products output schema
{
"type": "object",
"$defs": {
"BeautyProductItem": {
"type": "object",
"title": "BeautyProductItem",
"required": [
"beautyId",
"brandName",
"productName"
],
"properties": {
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Barcode",
"default": null
},
"beautyId": {
"type": "string",
"title": "Beautyid"
},
"imageUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Imageurl",
"default": null
},
"brandName": {
"type": "string",
"title": "Brandname"
},
"approvalNo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Approvalno",
"default": null
},
"attributes": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Attributes",
"default": null
},
"categoryMid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Categorymid",
"default": null
},
"distributor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Distributor",
"default": null
},
"formulation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Formulation",
"default": null
},
"productName": {
"type": "string",
"title": "Productname"
},
"capacityUnit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Capacityunit",
"default": "ml"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
},
"categoryLarge": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Categorylarge",
"default": null
},
"categorySmall": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Categorysmall",
"default": null
},
"minOfferPrice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Minofferprice",
"default": null
},
"capacityAmount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Capacityamount",
"default": null
},
"sensoryReviews": {
"type": "array",
"items": {
"$ref": "#/$defs/BeautySensoryReviewItem"
},
"title": "Sensoryreviews"
},
"functionalTypes": {
"type": "array",
"items": {
"type": "string"
},
"title": "Functionaltypes"
},
"minUnitPrice10ml": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Minunitprice10Ml",
"default": null
},
"standardUnitType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Standardunittype",
"default": "10ml"
}
}
},
"BeautySensoryReviewItem": {
"type": "object",
"title": "BeautySensoryReviewItem",
"required": [
"sensoryType",
"primaryTag"
],
"properties": {
"primaryTag": {
"type": "string",
"title": "Primarytag"
},
"reviewCount": {
"type": "integer",
"title": "Reviewcount",
"default": 0
},
"sensoryType": {
"type": "string",
"title": "Sensorytype"
},
"positiveRatio": {
"type": "number",
"title": "Positiveratio",
"default": 1
},
"summaryPoints": {
"type": "array",
"items": {
"type": "string"
},
"title": "Summarypoints"
},
"suitabilityAdvice": {
"type": "object",
"title": "Suitabilityadvice",
"additionalProperties": {
"type": "string"
}
}
},
"description": "2단계: 사용자 체감 제형·향·만족도 및 리뷰 요약 메타."
}
},
"title": "SearchBeautyProductsOut",
"required": [
"query",
"totalCount"
],
"properties": {
"query": {
"type": "string",
"title": "Query"
},
"notice": {
"type": "string",
"title": "Notice",
"default": "화장품 원장 후보입니다. 가격·인허가·안전성은 별도 확인이 필요합니다."
},
"products": {
"type": "array",
"items": {
"$ref": "#/$defs/BeautyProductItem"
},
"title": "Products"
},
"totalCount": {
"type": "integer",
"title": "Totalcount"
}
}
}search_beauty_products annotations
{
"title": "화장품 표준 상품 검색 / Search beauty products",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_beauty_product_detail — 화장품 기준 원장 및 전성분 상세 / Get beauty product detail
Advertised read-only
출처 미검증 화장품 원장의 기본 정보만 조회합니다. 인허가·전성분은 개별 근거 확인 전까지 비웁니다. Get basic catalog fields; regulatory and ingredient claims are withheld pending verification.
get_beauty_product_detail input schema
{
"type": "object",
"title": "get_beauty_product_detailArguments",
"properties": {
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Barcode",
"default": null,
"examples": [
"8809514550019"
],
"description": "880 바코드(GTIN-13) / 880 barcode"
},
"beauty_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Beauty Id",
"default": null,
"examples": [
"BP_8809514550019"
],
"description": "화장품 고유 ID (BP_...) / unique beauty ID"
},
"product_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Product Name",
"default": null,
"examples": [
"라운드랩 독도 토너"
],
"description": "상품명 검색어 / product name"
}
}
}get_beauty_product_detail output schema
{
"type": "object",
"$defs": {
"BeautyRecallItem": {
"type": "object",
"title": "BeautyRecallItem",
"required": [
"recallId",
"productName",
"reason"
],
"properties": {
"agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Agency",
"default": "식약처"
},
"reason": {
"type": "string",
"title": "Reason"
},
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Barcode",
"default": null
},
"recallId": {
"type": "string",
"title": "Recallid"
},
"actionDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Actiondate",
"default": null
},
"productName": {
"type": "string",
"title": "Productname"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
},
"categoryLarge": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Categorylarge",
"default": null
}
}
},
"BeautyProductItem": {
"type": "object",
"title": "BeautyProductItem",
"required": [
"beautyId",
"brandName",
"productName"
],
"properties": {
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Barcode",
"default": null
},
"beautyId": {
"type": "string",
"title": "Beautyid"
},
"imageUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Imageurl",
"default": null
},
"brandName": {
"type": "string",
"title": "Brandname"
},
"approvalNo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Approvalno",
"default": null
},
"attributes": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Attributes",
"default": null
},
"categoryMid": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Categorymid",
"default": null
},
"distributor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Distributor",
"default": null
},
"formulation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Formulation",
"default": null
},
"productName": {
"type": "string",
"title": "Productname"
},
"capacityUnit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Capacityunit",
"default": "ml"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
},
"categoryLarge": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Categorylarge",
"default": null
},
"categorySmall": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Categorysmall",
"default": null
},
"minOfferPrice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Minofferprice",
"default": null
},
"capacityAmount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Capacityamount",
"default": null
},
"sensoryReviews": {
"type": "array",
"items": {
"$ref": "#/$defs/BeautySensoryReviewItem"
},
"title": "Sensoryreviews"
},
"functionalTypes": {
"type": "array",
"items": {
"type": "string"
},
"title": "Functionaltypes"
},
"minUnitPrice10ml": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Minunitprice10Ml",
"default": null
},
"standardUnitType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Standardunittype",
"default": "10ml"
}
}
},
"BeautyIngredientItem": {
"type": "object",
"title": "BeautyIngredientItem",
"required": [
"ingredientSeq",
"nameKo"
],
"properties": {
"nameEn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Nameen",
"default": null
},
"nameKo": {
"type": "string",
"title": "Nameko"
},
"purpose": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Purpose",
"default": null
},
"ewgGrade": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Ewggrade",
"default": null
},
"ewgScore": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Ewgscore",
"default": null
},
"isAllergy25": {
"type": "boolean",
"title": "Isallergy25",
"default": false
},
"isCaution20": {
"type": "boolean",
"title": "Iscaution20",
"default": false
},
"ingredientSeq": {
"type": "integer",
"title": "Ingredientseq"
}
}
},
"BeautySensoryReviewItem": {
"type": "object",
"title": "BeautySensoryReviewItem",
"required": [
"sensoryType",
"primaryTag"
],
"properties": {
"primaryTag": {
"type": "string",
"title": "Primarytag"
},
"reviewCount": {
"type": "integer",
"title": "Reviewcount",
"default": 0
},
"sensoryType": {
"type": "string",
"title": "Sensorytype"
},
"positiveRatio": {
"type": "number",
"title": "Positiveratio",
"default": 1
},
"summaryPoints": {
"type": "array",
"items": {
"type": "string"
},
"title": "Summarypoints"
},
"suitabilityAdvice": {
"type": "object",
"title": "Suitabilityadvice",
"additionalProperties": {
"type": "string"
}
}
},
"description": "2단계: 사용자 체감 제형·향·만족도 및 리뷰 요약 메타."
}
},
"title": "GetBeautyDetailOut",
"properties": {
"notice": {
"type": "string",
"title": "Notice",
"default": "원장 기본 정보이며 인허가·전성분은 원천 확인 전까지 제공하지 않습니다."
},
"product": {
"anyOf": [
{
"$ref": "#/$defs/BeautyProductItem"
},
{
"type": "null"
}
],
"default": null
},
"ingredients": {
"type": "array",
"items": {
"$ref": "#/$defs/BeautyIngredientItem"
},
"title": "Ingredients"
},
"safetyRecall": {
"anyOf": [
{
"$ref": "#/$defs/BeautyRecallItem"
},
{
"type": "null"
}
],
"default": null
},
"sensoryReviews": {
"type": "array",
"items": {
"$ref": "#/$defs/BeautySensoryReviewItem"
},
"title": "Sensoryreviews"
}
}
}get_beauty_product_detail annotations
{
"title": "화장품 기준 원장 및 전성분 상세 / Get beauty product detail",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}compare_beauty_offers — 화장품 판매 관측 확인 / Check beauty offers
Advertised read-only
개별 원천 검증된 오퍼만 표시합니다. 현재 구 뷰티 원장에는 검증된 오퍼가 없어 빈 목록을 반환합니다. Only verified offers; the old beauty ledger currently has none.
compare_beauty_offers input schema
{
"type": "object",
"title": "compare_beauty_offersArguments",
"properties": {
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Barcode",
"default": null,
"examples": [
"8809514550019"
],
"description": "880 바코드 / 880 barcode"
},
"beauty_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Beauty Id",
"default": null,
"examples": [
"BP_8809514550019"
],
"description": "화장품 고유 ID (BP_...) / unique beauty ID"
}
}
}compare_beauty_offers output schema
{
"type": "object",
"$defs": {
"BeautyOfferItem": {
"type": "object",
"title": "BeautyOfferItem",
"required": [
"offerId",
"beautyId",
"mallCode",
"mallName",
"salePrice",
"deliveryFee",
"effectivePrice",
"unitPrice10ml",
"updatedAt"
],
"properties": {
"inStock": {
"type": "boolean",
"title": "Instock",
"default": true
},
"offerId": {
"type": "string",
"title": "Offerid"
},
"beautyId": {
"type": "string",
"title": "Beautyid"
},
"isRefill": {
"type": "boolean",
"title": "Isrefill",
"default": false
},
"mallCode": {
"type": "string",
"title": "Mallcode"
},
"mallName": {
"type": "string",
"title": "Mallname"
},
"directUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Directurl",
"default": null
},
"salePrice": {
"type": "integer",
"title": "Saleprice"
},
"updatedAt": {
"type": "string",
"title": "Updatedat"
},
"bundleCount": {
"type": "integer",
"title": "Bundlecount",
"default": 1
},
"couponPrice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Couponprice",
"default": null
},
"deliveryFee": {
"type": "integer",
"title": "Deliveryfee"
},
"unitPrice10ml": {
"type": "number",
"title": "Unitprice10Ml"
},
"effectivePrice": {
"type": "integer",
"title": "Effectiveprice"
}
}
}
},
"title": "CompareBeautyOffersOut",
"required": [
"beautyId",
"productName",
"capacity"
],
"properties": {
"notice": {
"type": "string",
"title": "Notice",
"default": "확인된 판매처 관측만 표시합니다."
},
"offers": {
"type": "array",
"items": {
"$ref": "#/$defs/BeautyOfferItem"
},
"title": "Offers"
},
"beautyId": {
"type": "string",
"title": "Beautyid"
},
"capacity": {
"type": "string",
"title": "Capacity"
},
"productName": {
"type": "string",
"title": "Productname"
},
"lowestUnitPrice10ml": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lowestunitprice10Ml",
"default": null
},
"lowestEffectivePrice": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Lowesteffectiveprice",
"default": null
}
}
}compare_beauty_offers annotations
{
"title": "화장품 판매 관측 확인 / Check beauty offers",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}analyze_ingredients — 입력 성분명 분류 / Classify supplied ingredient names
Advertised read-only
사용자가 직접 입력한 성분명을 분류합니다. 상품 원장의 전성분 출처와 피부 적합성은 확인되지 않았습니다. Classify user-supplied ingredient names; no product-specific ingredient or skin-safety claim.
analyze_ingredients input schema
{
"type": "object",
"title": "analyze_ingredientsArguments",
"properties": {
"ingredients_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Ingredients Text",
"default": null,
"examples": [
"정제수, 글리세린, 페녹시에탄올, 향료"
],
"description": "전성분 텍스트 (콤마 구분) / comma-separated ingredients text"
},
"product_name_or_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Product Name Or Id",
"default": null,
"examples": [
"설화수 윤조에센스",
"BP_8809514550019"
],
"description": "상품명 또는 beauty_id / product name or beauty_id"
}
}
}analyze_ingredients output schema
{
"type": "object",
"$defs": {
"BeautyIngredientItem": {
"type": "object",
"title": "BeautyIngredientItem",
"required": [
"ingredientSeq",
"nameKo"
],
"properties": {
"nameEn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Nameen",
"default": null
},
"nameKo": {
"type": "string",
"title": "Nameko"
},
"purpose": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Purpose",
"default": null
},
"ewgGrade": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Ewggrade",
"default": null
},
"ewgScore": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Ewgscore",
"default": null
},
"isAllergy25": {
"type": "boolean",
"title": "Isallergy25",
"default": false
},
"isCaution20": {
"type": "boolean",
"title": "Iscaution20",
"default": false
},
"ingredientSeq": {
"type": "integer",
"title": "Ingredientseq"
}
}
},
"BeautySensoryReviewItem": {
"type": "object",
"title": "BeautySensoryReviewItem",
"required": [
"sensoryType",
"primaryTag"
],
"properties": {
"primaryTag": {
"type": "string",
"title": "Primarytag"
},
"reviewCount": {
"type": "integer",
"title": "Reviewcount",
"default": 0
},
"sensoryType": {
"type": "string",
"title": "Sensorytype"
},
"positiveRatio": {
"type": "number",
"title": "Positiveratio",
"default": 1
},
"summaryPoints": {
"type": "array",
"items": {
"type": "string"
},
"title": "Summarypoints"
},
"suitabilityAdvice": {
"type": "object",
"title": "Suitabilityadvice",
"additionalProperties": {
"type": "string"
}
}
},
"description": "2단계: 사용자 체감 제형·향·만족도 및 리뷰 요약 메타."
},
"IngredientCautionSummary": {
"type": "object",
"title": "IngredientCautionSummary",
"required": [
"totalIngredientCount",
"caution20Count",
"allergy25Count"
],
"properties": {
"allergy25List": {
"type": "array",
"items": {
"type": "string"
},
"title": "Allergy25List"
},
"caution20List": {
"type": "array",
"items": {
"type": "string"
},
"title": "Caution20List"
},
"allergy25Count": {
"type": "integer",
"title": "Allergy25Count"
},
"caution20Count": {
"type": "integer",
"title": "Caution20Count"
},
"skinTypeAdvice": {
"type": "object",
"title": "Skintypeadvice",
"additionalProperties": {
"type": "string"
}
},
"ewgGradeDistribution": {
"type": "object",
"title": "Ewggradedistribution",
"additionalProperties": {
"type": "integer"
}
},
"totalIngredientCount": {
"type": "integer",
"title": "Totalingredientcount"
}
}
}
},
"title": "AnalyzeIngredientsOut",
"required": [
"summary"
],
"properties": {
"notice": {
"type": "string",
"title": "Notice",
"default": "사용자가 직접 입력한 성분명 자동 분류입니다. 안전성을 보증하지 않습니다."
},
"summary": {
"$ref": "#/$defs/IngredientCautionSummary"
},
"productName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Productname",
"default": null
},
"sensoryReviews": {
"type": "array",
"items": {
"$ref": "#/$defs/BeautySensoryReviewItem"
},
"title": "Sensoryreviews"
},
"analyzedIngredients": {
"type": "array",
"items": {
"$ref": "#/$defs/BeautyIngredientItem"
},
"title": "Analyzedingredients"
}
}
}analyze_ingredients annotations
{
"title": "입력 성분명 분류 / Classify supplied ingredient names",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}verify_cosmetic_safety — 화장품 안전 자료 확인 상태 / Cosmetic safety record status
Advertised read-only
공개 검증 가능한 인허가·회수 원천이 없어 상태를 미확인으로 반환합니다. 회수 기록 없음은 안전 판정이 아닙니다. No verified regulatory source is connected; absence of a recall row does not establish safety.
verify_cosmetic_safety input schema
{
"type": "object",
"title": "verify_cosmetic_safetyArguments",
"required": [
"barcode_or_name"
],
"properties": {
"barcode_or_name": {
"type": "string",
"title": "Barcode Or Name",
"examples": [
"8809514550019",
"독도 토너"
],
"maxLength": 100,
"minLength": 1,
"description": "바코드(880) 또는 화장품 상품명 / barcode or cosmetic product name"
}
}
}verify_cosmetic_safety output schema
{
"type": "object",
"$defs": {
"BeautyRecallItem": {
"type": "object",
"title": "BeautyRecallItem",
"required": [
"recallId",
"productName",
"reason"
],
"properties": {
"agency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Agency",
"default": "식약처"
},
"reason": {
"type": "string",
"title": "Reason"
},
"barcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Barcode",
"default": null
},
"recallId": {
"type": "string",
"title": "Recallid"
},
"actionDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Actiondate",
"default": null
},
"productName": {
"type": "string",
"title": "Productname"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
},
"categoryLarge": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Categorylarge",
"default": null
}
}
}
},
"title": "VerifySafetyOut",
"required": [
"query",
"verdict"
],
"properties": {
"query": {
"type": "string",
"title": "Query"
},
"notice": {
"type": "string",
"title": "Notice",
"default": "검증된 외부 원천과 실시간 대조하지 않았습니다."
},
"verdict": {
"type": "string",
"title": "Verdict"
},
"approvalNo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Approvalno",
"default": null
},
"isRecalled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Isrecalled",
"default": null
},
"recallInfo": {
"anyOf": [
{
"$ref": "#/$defs/BeautyRecallItem"
},
{
"type": "null"
}
],
"default": null
},
"isRegisteredApproved": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Isregisteredapproved",
"default": null
}
}
}verify_cosmetic_safety annotations
{
"title": "화장품 안전 자료 확인 상태 / Cosmetic safety record status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
0 advertised
Resources
0 advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1336 ms
- 95th percentile latency
- 1336 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1336 ms · metadata changed · 10 tool(s), 0 resource(s), 0 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http folsn-own-store-products-mcp https://mcp.folsn.com/public/mcpCodex
Codex configuration
codex mcp add folsn-own-store-products-mcp --url https://mcp.folsn.com/public/mcpCursor
Cursor configuration
{
"mcpServers": {
"folsn-own-store-products-mcp": {
"url": "https://mcp.folsn.com/public/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"folsn-own-store-products-mcp": {
"type": "streamableHttp",
"url": "https://mcp.folsn.com/public/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"folsn-own-store-products-mcp": {
"type": "http",
"url": "https://mcp.folsn.com/public/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http folsn-own-store-products-mcp https://mcp.folsn.com/public/mcpClaude Desktop
Claude Desktop configuration
{
"mcpServers": {
"folsn-own-store-products-mcp": {
"url": "https://mcp.folsn.com/public/mcp"
}
}
}Windsurf
Windsurf configuration
{
"mcpServers": {
"folsn-own-store-products-mcp": {
"serverUrl": "https://mcp.folsn.com/public/mcp"
}
}
}Let your agent find its tools
Find servers like Folsn Own-Store Products MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Folsn Own-Store Products MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.