Shopping agents
The lowest price per unit is not always the cheapest way to buy a requested quantity. For twelve identical items, two six-packs at $7.99 each cost less than two ten-packs at $11.99 each, even though the ten-pack has the lower unit price. First establish that the items are interchangeable; these tools do not verify compatibility.
$0.0018 for one successful call to each of the 3 tools below.
Preview three fixed scenarios for free, then explicitly choose whether to execute a capped request. Get the runnable example and instructions.
Compare each offer using unit each, quantity equal to the number of units in one pack, and the whole-pack price. A six-pack at $7.99 costs about $1.331667 per item; a ten-pack at $11.99 costs $1.199. This comparison alone does not choose how many packs to buy.
commerce.unit-price · $0.0005 per call ↗Set requiredUnits to 12, supply those pack sizes and prices, and set maxPacks to the actual limit you know for each offer. With ten packs available for each, the minimum item subtotal is $15.98: two six-packs, twelve items and no excess. Two ten-packs would cost $23.98. Prices tie-break by least excess, then fewest packs. Unknown stock is not unlimited; obtain a usable limit before planning.
commerce.pack-plan · $0.0008 per call ↗For each selected plan line, map its original offer price to unitPrice and its packs count to quantity; quantity here counts packs, not individual units. Supply explicit discounts and shipping, tax and fees. Keep unknown components null. The $15.98 item subtotal is not a verified delivered total.
commerce.price-components · $0.0005 per call ↗A minimum item-cost basket within supplied pack limits, plus a separate reconciliation of known checkout costs. Use interchangeable units in one currency. Shipping thresholds, coupons and cross-merchant costs can change the best delivered basket and are outside this planner. No merchant inventory is reserved and no order is placed.
These are separate API calls that your agent orchestrates, not an automatic bundled workflow. Review each tool's example and contract; input fields must be mapped explicitly between steps.
A small first step
Review its example and price, then create an API key and save your recovery key. Add $5 in service credits through Stripe and call the API from your agent.