WeBuyClubz — AI Golf Caddy, Club Catalog & Trade-In Engine

Search live pre-owned golf club inventory by keyword, category (Drivers, Fairway Woods, Hybrids, Irons, Wedges, Putters, Golf Sets), brand, shaft flex (Regular, Stiff, Senior / Lite, Extra Stiff, Ladies), dexterity (Right Handed, Left Handed), price range, and showroom branch (Pretoria or Cape Town).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search keyword (e.g. \"Paradym\", \"Stealth\", \"Vokey SM9\", \"Spider GT\", \"G425\")"
    },
    "category": {
      "type": "string",
      "description": "Category: Drivers, Fairway Woods, Hybrids, Irons, Wedges, Putters, Golf Sets, Accessories, Apparel"
    },
    "brand": {
      "type": "string",
      "description": "Brand: TaylorMade, Callaway, Titleist, Ping, Cobra, Mizuno, Cleveland, Srixon"
    },
    "flex": {
      "type": "string",
      "description": "Shaft flex: Regular, Stiff, Senior / Lite, Extra Stiff, Ladies"
    },
    "dexterity": {
      "type": "string",
      "description": "Dexterity: Right Handed or Left Handed"
    },
    "min_price": {
      "type": "number",
      "description": "Minimum price in ZAR"
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price in ZAR"
    },
    "branch": {
      "type": "string",
      "description": "Showroom location: pta (Pretoria), cpt (Cape Town), or all (default: all)"
    },
    "limit": {
      "type": "number",
      "description": "Max items to return (default: 10, max: 25)"
    }
  }
}

Fetch detailed specifications for a specific golf club: loft, shaft model, grip condition, detailed condition score (e.g. 8/10 - Very Good), showroom location, high-resolution photo gallery URLs, live price, and product page URL.

{
  "type": "object",
  "properties": {
    "product_id_or_slug": {
      "type": "string",
      "description": "Product ID (e.g. \"prod_123\") or URL slug"
    }
  },
  "required": [
    "product_id_or_slug"
  ]
}

Provide personalized golf club recommendations and expert caddy advice based on golfer handicap, swing speed, typical shot miss/fault (slice, hook, low launch), target club type, and budget.

{
  "type": "object",
  "properties": {
    "handicap": {
      "type": "number",
      "description": "Golfer handicap index (e.g. 18)"
    },
    "swing_speed": {
      "type": "string",
      "description": "Swing speed: slow, moderate, fast, tour"
    },
    "shot_fault": {
      "type": "string",
      "description": "Common shot miss: slice, hook, low launch, ballooning, distance loss"
    },
    "target_club_type": {
      "type": "string",
      "description": "Target club type: Driver, Fairway Wood, Hybrid, Irons, Wedges, Putter"
    },
    "budget_zar": {
      "type": "number",
      "description": "Maximum budget in South African Rand (ZAR)"
    }
  },
  "required": [
    "handicap",
    "target_club_type"
  ]
}

Calculate an instant valuation estimate for a customer looking to trade in or sell their used golf clubs to WeBuyClubz, including estimated cash payout and +15% store credit bonus.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand name (e.g. Callaway, Titleist, TaylorMade, Ping)"
    },
    "club_type": {
      "type": "string",
      "description": "Driver, Iron Set, Fairway Wood, Hybrid, Wedge, Putter"
    },
    "model_name": {
      "type": "string",
      "description": "Exact club model (e.g. SIM2 Max, Rogue ST Max, Stealth)"
    },
    "condition_rating": {
      "type": "number",
      "description": "Condition rating out of 10 (5 to 10, default: 7)"
    }
  },
  "required": [
    "brand",
    "club_type",
    "model_name"
  ]
}

Build a shopping cart session with selected items and generate a secure 1-click checkout link (preloaded into the WeBuyClubz cart drawer with instant Yoco / Payflex checkout).

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Array of items to purchase",
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string",
            "description": "Product ID or slug"
          },
          "quantity": {
            "type": "number",
            "description": "Quantity (default: 1)"
          }
        },
        "required": [
          "product_id"
        ]
      }
    },
    "customer": {
      "type": "object",
      "description": "Optional customer contact & delivery details to prefill in checkout",
      "properties": {
        "name": {
          "type": "string",
          "description": "Customer full name"
        },
        "email": {
          "type": "string",
          "description": "Customer email address"
        },
        "phone": {
          "type": "string",
          "description": "Customer mobile phone number"
        },
        "city": {
          "type": "string",
          "description": "Delivery city"
        },
        "shipping_street": {
          "type": "string",
          "description": "Street address"
        },
        "shipping_postal_code": {
          "type": "string",
          "description": "Postal code"
        }
      }
    }
  },
  "required": [
    "items"
  ]
}

Retrieve store operating hours, physical showroom addresses in Pretoria (Equestria) & Cape Town (Brackenfell), nationwide courier rates, payment options, and customer guarantees.

{
  "type": "object",
  "properties": {}
}

Securely check customer order status, payment state, fulfillment progress, and courier tracking details by order ID/number and matching customer email or phone.

{
  "type": "object",
  "properties": {
    "order_id_or_number": {
      "type": "string",
      "description": "Order ID (e.g. ord_123) or Order Number (e.g. 4639)"
    },
    "customer_email_or_phone": {
      "type": "string",
      "description": "Customer email or phone number matching the order"
    }
  },
  "required": [
    "order_id_or_number",
    "customer_email_or_phone"
  ]
}