find_shoesread-only
Search VIVAIA products by structured criteria: category, toe shape, heel height, size, color, price range, or a free-text keyword such as a model name. Returns up to 10 in-stock products with handle, price and product…
keyword: string?, product_type: string?, toe: string?, heel: string?, size_jp: number?, size_eu: number?, color: string?, price_min: integer?, price_max: integer?, sort: string?, navigate: boolean?
get_cartread-only
Read the current shopping cart: each line id, product title, color and size, quantity, line price, whether the line is selected for checkout, and the cart total. Works from any page and changes nothing.
get_productread-onlyuntrusted content
Get details for one VIVAIA product: title, price, color and size options, and every variant with its in-stock status and variant id. Pass the variant id to update_cart to add the item. Accepts a product handle or a…
product: string?, selected_options: array?
get_purchase_historyread-only
Get the signed-in customer's recent orders (up to 10) with product, color, size, quantity and price, plus a size profile: the sizes bought most often and most recently. Use it for questions like "what did I buy"…
get_recommendationsread-only
Get personalized product recommendations for the signed-in customer (up to 10) based on their browsing and purchase history. Returns handle, title, price and product URL. Anonymous visitors get an empty result; in…
exclude: string?
get_store_inventoryread-only
Check in-store stock of one variant at VIVAIA's four physical stores in Japan (ハラカド店, 新宿マルイ本館店, 二子玉川店, グラングリーン大阪店). Give the product handle plus the size via selected_options, or a variant_id from get_product. Returns…
product: string?, variant_id: string?, selected_options: array?
open_page
Navigate the browser to a page of this store. target is one of: home, cart, favorites, orders, account, login (sign-in page; the customer enters credentials themselves and returns to the current page), search (with…
target: string, term: string?, handle: string?
proceed_to_checkoutasks to confirm
Start checkout for the cart lines currently selected. Verifies the cart is not empty, then MOVES the browser to the secure checkout page where the customer reviews the order and completes payment. The result confirms…
show_product
Navigate the browser to a product page with a color or size preselected. Give the product handle plus either variant_id or partial selected_options such as only the size; the first in-stock matching variant is chosen…
product: string?, variant_id: string?, selected_options: array?
subscribe_newsletter
Subscribe an email address to the VIVAIA newsletter. Ask the customer for their email address first, then submit this form with it. Returns whether the subscription succeeded or the address was already subscribed.
email: string?
toggle_favorite
Add a product to, or remove it from, the signed-in customer's favorites (お気に入り). Pass the product handle or product page URL and action "add" or "remove"; when product is omitted the product page currently open is…
product: string?, action: string
update_cart
Add products to the cart, change line quantities, or remove lines. Batch every change of one request into a SINGLE call with up to 10 line_items. To add an item pass variant_id from get_product. To change or remove an…
line_items: array