Input Schema

{
    "type": "object",
    "properties": {
        "sku": {
            "type": "string",
            "description": "Exact product lookup by merchant SKU. When set (and `gtin` is not), returns exact match. Combine with `merchant` to disambiguate the same SKU across merchants."
        },
        "gtin": {
            "type": "string",
            "description": "Exact product lookup by GTIN/EAN barcode (8/12/13/14 digits). When set, `query` and all other filters are ignored. First attempts a strict EAN match; if the catalog has no clean GTIN for that code, falls back to semantic search using the code as query text."
        },
        "page": {
            "type": "integer",
            "default": 1,
            "minimum": 1,
            "description": "1-indexed page number for browse mode (ignored when `query` is set or list_merchants is true)"
        },
        "brand": {
            "type": "string",
            "description": "DEPRECATED alias of `merchant` (kept for backward compatibility). Filters by SELLER/merchant, NOT by product brand. Use `merchant` instead; for product brand use `product_brand`."
        },
        "limit": {
            "type": "integer",
            "default": 10,
            "maximum": 20,
            "minimum": 1,
            "description": "Max products returned by a `query` search (default 10, max 20). Ignored when browsing without `query`."
        },
        "query": {
            "type": "string",
            "minLength": 2,
            "description": "Natural-language product search \u2014 use for any product intent or recommendation request. Include attributes the user mentioned (color, use case, budget context). When present, `page` is ignored."
        },
        "category": {
            "type": "string",
            "description": "Filter to one product category. Exact match in `query` mode (Qdrant payload); substring/case-insensitive in browse mode."
        },
        "merchant": {
            "type": "string",
            "description": "Filter products to one merchant/store (merchant_program name returned by list_merchants, e.g. \"evomag.ro\"). Filters by SELLER, not by product brand \u2014 for product brand use `product_brand`."
        },
        "age_group": {
            "enum": [
                "infant",
                "toddler",
                "preschool",
                "elementary",
                "middle_school",
                "high_school",
                "adult"
            ],
            "type": "string",
            "description": "Age group filter for school/kids products."
        },
        "max_price": {
            "type": "number",
            "description": "Maximum price in RON (both modes)",
            "exclusiveMinimum": 0
        },
        "min_price": {
            "type": "number",
            "description": "Minimum price in RON (both modes)",
            "exclusiveMinimum": 0
        },
        "product_brand": {
            "type": "string",
            "description": "Product brand filter (e.g., \"nike\", \"adidas\", \"chanel\"). Filters by the manufacturer brand of the product, NOT by the selling merchant."
        },
        "product_color": {
            "type": "string",
            "description": "Color filter (e.g., \"negru\", \"alb\", \"rosu\")."
        },
        "list_merchants": {
            "type": "boolean",
            "default": false,
            "description": "If true, return merchant groups (name, domain, productCount) instead of products"
        },
        "product_gender": {
            "enum": [
                "male",
                "female",
                "unisex"
            ],
            "type": "string",
            "description": "Gender filter: \"male\" for b\u0103rba\u021bi/men, \"female\" for femei/women, \"unisex\" for gender-neutral products (any age). For children's products use `age_group`, NOT this field."
        }
    },
    "additionalProperties": false
}