Bambu Store

bambu-store

Two commands do all the work and return JSON. Invoke both by full path — the working directory is not the skill directory.

When to use

• The user asks the price, sale status or stock of any Bambu Lab filament.
• The user wants to order filament: add rolls, change quantities, remove a line.
• The user asks what their Bambu order would cost, including tax and shipping.

When NOT to use

• Anything that is not filament — printers, hotends, build plates, spare parts.
• Any store other than the Bambu Lab US store.
• Paying for the order. The user pays themselves at us.store.bambulab.com/cart; these commands never charge.

Tools

add and set change the user's real cart. Pass --confirm only after the user has approved that exact change in words.

Turning the user's words into a call

Always include the colour in --item ("ASA white", "PLA Matte Ash Grey"). The colour is what picks the exact roll.

Output shape

Every store_api.py call prints one JSON object. Success has "ok": true:

{"ok": true, "item_count": 2, "total": 51.98,
 "lines": [{"line_id": "1839...", "name": "PLA Basic", "color": "Jade White",
            "quantity": 2, "price": 25.99, "line_total": 51.98,
            "included_in_total": true, "in_stock": true}]}

Failure has "ok": false and an error string to read back to the user:

{"ok": false, "error": "the store has no filament matching 'PLA Sparkle Teal'"}

checkout returns grand_total, subtotal, discount, shipping, tax and charged: false.

Common flows

Price check. bambu-store-v2 search "ASA white" --json → report in stock or not, the price now, and the was price when on_sale is true. Stop there.

Building an order.

1. bambu-store-v2 search "PLA Matte Ash Grey" --json → read back material, colour and price.
2. Ask the user to confirm the item and the quantity in plain words.
3. store_api.py add --item "PLA Matte Ash Grey" --qty 2 --confirm
4. store_api.py checkout → read back the grand total, then tell the user the order is waiting in their account and to complete payment at us.store.bambulab.com/cart.

Adjusting an order. store_api.py cart → name the line in words ("the two rolls of Jade White PLA Basic") → get the user's approval → store_api.py set --line <line_id> --qty <n> --confirm.

Errors

A failed call prints {"ok": false, "error": "..."}. Read the error text back to the user in plain words.

• "needs a specific colour" — ask the user which colour they want, then call add again with the colour in --item.
• "the store sign-in has expired" or "has not been set up" — tell the user the store sign-in needs refreshing. Price and stock lookups keep working.
• "there is no cart line" — run cart again and read the current line_ids.

Always ask the user for guidance when there is an error; do not proactively try to resolve errors yourself.

Empty results

When a search returns "count": 0 or no_match, say that the store has no filament matching those words and ask the user for the material and colour as the store names them ("PLA Basic", "PLA Matte", "PETG HF", "ASA"). Do not guess a product name. An empty cart returns "item_count": 0 with "lines": [] — say the cart is empty.