tools-it.fly.dev

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "What to look for, natural language, e.g. \"men's pants\""
    },
    "section": {
      "description": "Force a store section; otherwise inferred from the query",
      "type": "string",
      "enum": [
        "MAN",
        "WOMAN",
        "KID"
      ]
    },
    "limit": {
      "description": "Max products to return (default 24)",
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    },
    "min_price": {
      "description": "Only items at or above this price, in the store currency",
      "type": "number"
    },
    "max_price": {
      "description": "Only items at or below this price, in the store currency (e.g. 200 = ₪200)",
      "type": "number"
    },
    "on_sale_only": {
      "description": "Only items currently reduced",
      "type": "boolean"
    },
    "min_discount_pct": {
      "description": "Only items reduced by at least this percent (e.g. 30)",
      "type": "number",
      "minimum": 1,
      "maximum": 90
    },
    "colors": {
      "description": "Only items available in any of these colors, e.g. [\"black\",\"beige\"]",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "include_words": {
      "description": "Product name must contain all of these words, e.g. [\"linen\"]",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "exclude_words": {
      "description": "Drop items whose name contains any of these words, e.g. [\"jogging\"]",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "size": {
      "description": "Only items with THIS size in live stock (e.g. \"M\", \"42\"). Checks real per-size availability.",
      "type": "string"
    },
    "in_my_size_only": {
      "description": "Only items in live stock in the human's saved size (size systems converted automatically). Costs a live per-size check of up to 36 candidates per call (a few seconds); the result says how many were checked and, via hasMore/nextOffset, whether to call again with offset.",
      "type": "boolean"
    },
    "sort": {
      "description": "Result order (default relevance) — applied to every match, not just the first page",
      "type": "string",
      "enum": [
        "relevance",
        "price_asc",
        "price_desc",
        "discount"
      ]
    },
    "offset": {
      "description": "Skip this many matches (after filters and sort) — paging: use nextOffset from the previous result",
      "type": "integer",
      "minimum": 0,
      "maximum": 2000
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}