{"ok":true,"site":{"host":"shop.alshhbaa.com","url":"https://shop.alshhbaa.com/","type":"live","desc":"","tools":[{"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.","title":"البحث في كتالوج نحاسيات الشهباء","annotations":{"readOnlyHint":true},"inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":100},"limit":{"type":"integer","minimum":1,"maximum":12,"default":8}},"required":["query"],"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"بيانات نحاسيات الشهباء المنظمة","annotations":{"readOnlyHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"البحث في منتجات المتجر","annotations":{"readOnlyHint":true},"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},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"name":"get_product_details","kind":"answer","impl":"imperative","description":"Provides product details, VAT-inclusive price in SAR, stock status, specifications, SKU, and product URL.","title":"تفاصيل منتج محدد","annotations":{"readOnlyHint":true},"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."}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"إضافة منتج إلى سلة التسوق","annotations":{"readOnlyHint":false},"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},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"بدء عملية الدفع والطلب","annotations":{"readOnlyHint":false},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"إتمام الطلب وبدء الدفع","annotations":{"readOnlyHint":false},"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},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"عرض محتويات سلة التسوق","annotations":{"readOnlyHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"استرجاع اقتراحات المنتجات","annotations":{"readOnlyHint":true},"inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"The search query for product suggestions."}},"required":["query"]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"عرض جميع منتجات المتجر","annotations":{"readOnlyHint":true},"inputSchema":{"type":"object","properties":{}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"استرجاع المنتجات حسب القسم","annotations":{"readOnlyHint":true},"inputSchema":{"type":"object","properties":{"category":{"type":"string","description":"The category of products to retrieve (e.g., 'ثريات', 'اكسسوارات', 'جداريات', 'ابجورات')."}},"required":["category"]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"استعلام شركات الشحن المتاحة وأسعارها","annotations":{"readOnlyHint":true},"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},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"معلومات متجر نحاسيات الشهباء","annotations":{"readOnlyHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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.","title":"البحث في منتجات متجر الشهباء","annotations":{"readOnlyHint":true},"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},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"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":"ابحث عن ثريات، أباجورات..."}}},"__source":"spec","__declarative":true,"page":"/","pages":["/","/categories","/products","/new-arrivals","/shipping","/articles/chandelier-buying-guide"]},{"name":"filter_products","kind":"act","impl":"declarative","description":"ترتيب وتصفية منتجات الكتالوج","inputSchema":{"type":"object","properties":{"sort":{"type":"string","enum":["newest","price_asc","price_desc","name_asc"]}}},"__source":"spec","__declarative":true,"page":"/products","pages":["/products","/new-arrivals"]},{"name":"paginate_catalog","kind":"act","impl":"declarative","description":"تغيير عدد المنتجات المعروضة والتنقل في صفحات الكتالوج","inputSchema":{"type":"object","properties":{"perPage":{"type":"string","enum":["24","48","72","96"]}}},"__source":"spec","__declarative":true,"page":"/products","pages":["/products"]}],"category":"Commerce","favicon":"/favicons/shop.alshhbaa.com.png","apiSurface":"spec","toolCount":17}}