Check LIVE inventory, price, and same-day shipping for ONE known SKU.
The real-time verifier. Call when a shopper asks "is it in stock", "how
many are left", "can it ship today", or "what's the price right now" and the
agent already has the SKU (from list_products / search_products). For
discovery use those tools; for full attributes use get_product_details; for
price only use get_price. Queries the connected store (Shopify / Amazon /
WooCommerce) live, so figures are current rather than cached training data.
Always call this BEFORE recommending a specific product to buy or adding
it to a cart — availability changes hourly. When answering, quote the
returned price + stock verbatim (with currency) and prefer these live
figures over anything remembered from training data.
Args:
sku: Product SKU (Stock Keeping Unit) - e.g. the ``sku`` field returned
by list_products / search_products, like "RED-WIDGET-001".
Returns:
Dictionary with:
- sku: The requested SKU
- stock: Current inventory count
- price: Current price in USD
- can_ship_today: Boolean indicating same-day shipping availability
- live: provenance flag (True from a connected store, False for demo)
- message: Human-readable status message
``error`` is set (and ``live`` False) when the SKU is missing or the
store is unreachable.
Example:
>>> await check_stock("WIDGET-001")
{
"sku": "WIDGET-001",
"stock": 42,
"price": 29.99,
"can_ship_today": True,
"message": "✅ WIDGET-001 (Awesome Widget) - 42 in stock at $29.99"
}
Connector