shop.alshhbaa.com

{
  "name": "alshhbaa_search_catalog",
  "kind": "act",
  "impl": "imperative",
  "description": "Search published products and categories. Returns Arabic labels and storefront links; read each product page for live price, stock and options.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 12,
        "default": 8
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "alshhbaa_store_reference",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the canonical Organization, OnlineStore and WebSite graph, including verified contacts and links to shipping and return policies. No customer data.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "search_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search products in the catalog by query keywords, category, or maximum price. Returns an array of matching products with name, price, inStock status, and storefront URL.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100,
        "description": "Search keyword, product name, or phrase (e.g. ثريا كلاسيك, أباجورة, chandelier, lamp)."
      },
      "category": {
        "type": "string",
        "description": "Optional category name to filter by (e.g. ثريات, ابجورات)."
      },
      "max_price": {
        "type": "number",
        "description": "Optional maximum price filter in SAR."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 20,
        "default": 8,
        "description": "Maximum number of results to return (1-20)."
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_product_details",
  "kind": "answer",
  "impl": "imperative",
  "description": "Provides product details, VAT-inclusive price in SAR, stock status, specifications, SKU, and product URL.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_name": {
        "type": "string",
        "description": "The name of the product to get details for."
      },
      "product_id": {
        "type": "integer",
        "description": "Optional numeric product ID."
      },
      "slug": {
        "type": "string",
        "description": "Optional product URL slug."
      }
    }
  },
  "page": "/"
}

{
  "name": "add_to_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Add a product to the shopping cart by product ID and quantity. Returns updated cart summary including totalItems, totalPrice, and confirmation message.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "productId": {
        "type": "integer",
        "minimum": 1,
        "description": "Numeric ID of the product to add."
      },
      "product_id": {
        "type": "integer",
        "minimum": 1,
        "description": "Numeric ID of the product to add (alias for productId)."
      },
      "product_name": {
        "type": "string",
        "description": "Product name or keywords to resolve and add if productId is not known."
      },
      "quantity": {
        "type": "integer",
        "minimum": 1,
        "default": 1,
        "description": "Quantity of the item to add."
      },
      "nameAr": {
        "type": "string",
        "description": "Arabic name of the product (optional)."
      },
      "sku": {
        "type": "string",
        "description": "Product SKU (optional)."
      },
      "optionsKey": {
        "type": "string",
        "default": "",
        "description": "Selected option variant key (optional)."
      },
      "optionsText": {
        "type": "string",
        "default": "",
        "description": "Human-readable options text (optional)."
      },
      "imagePath": {
        "type": "string",
        "default": "",
        "description": "Product image thumbnail path (optional)."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "start_checkout",
  "kind": "transact",
  "impl": "imperative",
  "description": "Proceed to checkout with the current cart items. Returns the checkout URL, order total, and instructions to complete shipping and payment.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "submit_checkout",
  "kind": "transact",
  "impl": "imperative",
  "description": "Start checkout or place an order with customer shipping address, contact details, and payment method. Returns an order checkout response object with checkoutUrl, totalItems, totalPrice, and order status.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "customerName": {
        "type": "string",
        "description": "Customer full name."
      },
      "phone": {
        "type": "string",
        "description": "Customer phone number (Saudi mobile, e.g. 05xxxxxxxx)."
      },
      "city": {
        "type": "string",
        "description": "Delivery city in Saudi Arabia (e.g. الرياض, جدة)."
      },
      "address": {
        "type": "string",
        "description": "Delivery street address or district."
      },
      "notes": {
        "type": "string",
        "description": "Optional delivery or order notes."
      },
      "paymentMethod": {
        "type": "string",
        "enum": [
          "stream",
          "tamara",
          "bank_transfer",
          "cod"
        ],
        "default": "stream",
        "description": "Selected payment method."
      }
    },
    "required": [
      "customerName",
      "phone",
      "city",
      "address"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_cart",
  "kind": "answer",
  "impl": "imperative",
  "description": "Retrieve the current user shopping cart items, quantities, VAT-inclusive unit prices, and total price including VAT and shipping in SAR.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_product_suggestions",
  "kind": "answer",
  "impl": "imperative",
  "description": "Retrieves product suggestions and autocomplete matches based on a search query keyword. Returns an array of matching suggestion objects with label, detail, and URL.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "The search query for product suggestions."
      }
    },
    "required": [
      "query"
    ]
  },
  "page": "/"
}

{
  "name": "get_all_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "Lists available products with VAT-inclusive prices in SAR, stock status, and product URLs, along with the total count.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "get_products_by_category",
  "kind": "answer",
  "impl": "imperative",
  "description": "Retrieves products belonging to a specific category (e.g. 'ثريات', 'اكسسوارات', 'جداريات', 'ابجورات'). Prices are VAT-inclusive in SAR.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "category": {
        "type": "string",
        "description": "The category of products to retrieve (e.g., 'ثريات', 'اكسسوارات', 'جداريات', 'ابجورات')."
      }
    },
    "required": [
      "category"
    ]
  },
  "page": "/"
}

{
  "name": "get_shipping_carriers",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get available shipping carriers, delivery time estimates, and shipping fees for any city in Saudi Arabia (e.g. الرياض, جدة, مكة المكرمة, الدمام). Returns carriers array with name, cost, and delivery estimate.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "city": {
        "type": "string",
        "minLength": 2,
        "maxLength": 100,
        "description": "City name in Saudi Arabia in Arabic (e.g. الرياض, جدة, الدمام)."
      }
    },
    "required": [
      "city"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_store_info",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get Alshhbaa Copperware verified company details, physical showroom address in Jeddah, phone and WhatsApp contacts, operating hours, and warranty policies. Returns store profile details.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "search_alshhbaa_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the Alshhbaa Copperware catalog for handcrafted chandeliers, chandelier accessories, lamps, and wall sconces. Returns matching products and categories with prices and URLs.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100,
        "description": "Search keyword, product name, or phrase (e.g. ثريا كلاسيك, أباجورة, chandelier, lamp)."
      },
      "category": {
        "type": "string",
        "description": "Optional category name to filter by (e.g. ثريات, ابجورات)."
      },
      "max_price": {
        "type": "number",
        "description": "Optional maximum price filter in SAR."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 20,
        "default": 8,
        "description": "Maximum number of results to return (1-20)."
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "search_products",
  "kind": "answer",
  "impl": "declarative",
  "description": "Search products in the catalog by query keywords, category, or maximum price. Returns an array of matching products with name, price, inStock status, and storefront URL.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "q": {
        "type": "string",
        "description": "ابحث عن ثريات، أباجورات..."
      }
    }
  },
  "page": "/"
}

{
  "name": "filter_products",
  "kind": "act",
  "impl": "declarative",
  "description": "ترتيب وتصفية منتجات الكتالوج",
  "inputSchema": {
    "type": "object",
    "properties": {
      "sort": {
        "type": "string",
        "enum": [
          "newest",
          "price_asc",
          "price_desc",
          "name_asc"
        ]
      }
    }
  },
  "page": "/products"
}

{
  "name": "paginate_catalog",
  "kind": "act",
  "impl": "declarative",
  "description": "تغيير عدد المنتجات المعروضة والتنقل في صفحات الكتالوج",
  "inputSchema": {
    "type": "object",
    "properties": {
      "perPage": {
        "type": "string",
        "enum": [
          "24",
          "48",
          "72",
          "96"
        ]
      }
    }
  },
  "page": "/products"
}