The agent as shopper.On real stores.
Your agent buys the way a person would — browsing, adding to cart, checking out — on real storefronts, through a hosted browser-worker. The same mandate that governs every other spend governs this one too.
The reorder nobody built an API for.
Packing tape, boxes, gloves, office supplies — the recurring low-value spend that never got a procurement integration. Someone re-opens the same storefront, rebuilds the same cart, and pays with a card nobody's tracking. Shop replaces that with a governed purchase on the same store, no vendor project required.
Open the supplier's site and rebuild the same cart from memory, every reorder cycle
The agent drives the real storefront and rebuilds last cycle's cart automatically
Wait on the vendor's dev team for an API or punch-out catalog before automating anything
A hosted browser session buys through the storefront exactly as it exists today — no vendor project
Hand a shared card to whoever restocks, with no spend ceiling and no owner
Every checkout runs inside a signed mandate with its own cap, no shared credentials
Dig up a confirmation email later to prove what was actually bought
A sealed receipt binds the cart, checkout, and mandate into one record
A hosted browser, not a scraped API.
Most storefronts were built for people clicking through a browser, not for API integrations. Shop drives a real, hosted browser-worker through the storefront the way a shopper would, so it works on stores that never built agent access on purpose.
Illustrative flow. The mandate caps what the agent can spend before checkout ever starts.
The same mandate that authorizes a purchase can block one. Here's a cart that comes in over the cap.
Illustrative example. The cap check runs against the cart total before the store's checkout ever completes.
Coverage, honestly.
VTEX is proven — a real purchase has gone through in production. Mercado Livre and Nuvemshop are named in the same mechanism; check current status before assuming parity with VTEX.
codespar_shop takes an intent, not a SKU list.
The agent doesn't call a REST endpoint — it hands codespar_shop a natural-language intent and a mandate. The tool drives the hosted browser through the real storefront, and codespar_pay settles whatever Pix the store mints at checkout, still inside the same cap.
const session = await codespar.sessions.create(); // mandate caps the cart before checkout ever opens const shop = await session.execute("codespar_shop", { intent: "Reorder packing tape and boxes, same cart as last cycle.", merchant: "embalasul.com.br", mandate: "cm_supplies", cap: { amount: 500_000, currency: "BRL" }, }); // the store's own checkout — not a CodeSpar endpoint, so we poll it const receipt = await session.execute("codespar_shop", { action: "checkout", id: shop.id, }); // settle the store's minted Pix, still inside the same mandate await session.execute("codespar_pay", { method: "pix", mandate: "cm_supplies" });
What this call chain does
- The mandate caps the cart before checkout ever opens
- Checkout runs on the store's own page — CodeSpar polls it, not a special integration
- Settlement stays inside the same mandate the cart was capped under
One proven storefront. More coming.
Shop's mechanism works on any storefront a hosted browser can navigate. Here's the honest line between what's proven and what's named but unconfirmed.
- VTEX — a real purchase has run in production
- Every purchase runs inside the signed procurement mandate before checkout starts
- Mercado Livre — named in the mechanism, not yet confirmed at VTEX's level
- Nuvemshop — named in the mechanism, not yet confirmed at VTEX's level
- The mechanism generalizes to any storefront a hosted browser can navigate — not limited to the platforms named today
Not priced yet — pre-GA.
Shop carries a pricing commitment for general availability, locked to the published rate card, not a promise of availability. It isn't billed today.
LiveLive — a real purchase on VTEX has run in production.
See Shop in a real business case.
One workflow where this hosted-browser checkout already runs, end to end.
Agent storefront shopping→
Buys on VTEX like a real shopper — browse, cart, checkout — under the same mandate that caps every other purchase.
Shop, answered
VTEX is proven in production. Mercado Livre and Nuvemshop are named in the same mechanism — check current coverage before relying on them.
Through a hosted browser-worker that navigates the storefront the way a person would — browse, cart, checkout.
The same signed mandate that governs every other spend the agent makes.
It isn't priced yet. There's a published pricing commitment for general availability, not a live charge today.
No — that's the point of the hosted browser-worker. It works on stores that never built for agent access.
No. It's a governed, mandate-checked purchase flow through a real browser session, not scraping product data.
The purchase is blocked before checkout completes — Shop checks the cart total against the mandate cap first, so nothing clears over the ceiling.
Yes — every purchase seals into a receipt that binds the cart, the checkout confirmation, and the mandate into one audit record.
Let your agent shop for real.
A hosted browser, a real storefront, the same mandate that governs everything else.
shop: Live — a real purchase on VTEX has run in production.