Walmart
Overview
E-commerce. Walmart.com — product search, detail pages, pricing, and cart operations. Read ops use Next.js SSR extraction; write ops use an adapter with persisted GraphQL mutations via browser context.
Workflows
Search and view product
searchProducts(q) → browse results → usItemIdgetProductDetail(slug, itemId) → full product info (name, brand, price, reviews, images)
Compare pricing
searchProducts(q) → find products → usItemIdgetProductPricing(itemId) → currentPrice, wasPrice, savingsAmount, isPriceReduced
Search and add to cart
searchProducts(q) → browse results → usItemIdaddToCart(usItemId, quantity) → cartId, cartCount, item details
Remove from cart
searchProducts(q) or prior addToCart → usItemIdremoveFromCart(usItemId) → cartId, cartCount, removedItemId
Operations
| Operation |
Intent |
Key Input |
Key Output |
Notes |
| searchProducts |
search products by keyword |
q |
name, usItemId, linePrice, averageRating |
entry point; returns itemStacks |
| getProductDetail |
full product page |
slug, itemId ← searchProducts |
name, brand, priceInfo, averageRating, numberOfReviews, imageInfo |
slug can be any string |
| getProductPricing |
focused pricing info |
itemId ← searchProducts |
currentPrice, wasPrice, savingsAmount, isPriceReduced |
subset of product detail |
| addToCart |
add product to cart |
usItemId ← searchProducts, quantity |
cartId, cartCount, item |
⚠️ write op, adapter-based |
| removeFromCart |
remove product from cart |
usItemId ← addToCart / searchProducts |
cartId, cartCount, removedItemId |
⚠️ write op; idempotent — adapter seeds qty=1 via updateItems before removal so a fresh usItemId works without a prior addToCart |
Known Limitations
- Cart write ops require open walmart.com tab in the managed browser. The adapter posts persisted GraphQL mutations from the page context.
- PerimeterX rate-limits cart calls. Repeated addToCart/removeFromCart bursts return HTTP 429 from
/orchestra/{cartxo,home}/graphql/* for ≥1 h. Wait or rotate network/profile to recover; no code change needed.
Quick Start
# Search for products
openweb walmart exec searchProducts '{"q": "laptop"}'
# Get full product detail (slug can be any non-empty string)
openweb walmart exec getProductDetail '{"slug": "item", "itemId": "5113175776"}'
# Get focused pricing
openweb walmart exec getProductPricing '{"itemId": "5113175776"}'
# Add to cart (requires browser page on walmart.com)
openweb walmart exec addToCart '{"usItemId": "5113175776", "quantity": 1}'
# Remove from cart (requires browser page on walmart.com)
openweb walmart exec removeFromCart '{"usItemId": "5113175776"}'
1---2name: walmart3description: Walmart4---5# Walmart67## Overview8E-commerce. Walmart.com — product search, detail pages, pricing, and cart operations. Read ops use Next.js SSR extraction; write ops use an adapter with persisted GraphQL mutations via browser context.910## Workflows1112### Search and view product131. `searchProducts(q)` → browse results → `usItemId`142. `getProductDetail(slug, itemId)` → full product info (name, brand, price, reviews, images)1516### Compare pricing171. `searchProducts(q)` → find products → `usItemId`182. `getProductPricing(itemId)` → currentPrice, wasPrice, savingsAmount, isPriceReduced1920### Search and add to cart211. `searchProducts(q)` → browse results → `usItemId`222. `addToCart(usItemId, quantity)` → cartId, cartCount, item details2324### Remove from cart251. `searchProducts(q)` or prior `addToCart` → `usItemId`262. `removeFromCart(usItemId)` → cartId, cartCount, removedItemId2728## Operations2930| Operation | Intent | Key Input | Key Output | Notes |31|-----------|--------|-----------|------------|-------|32| searchProducts | search products by keyword | q | name, usItemId, linePrice, averageRating | entry point; returns itemStacks |33| getProductDetail | full product page | slug, itemId ← searchProducts | name, brand, priceInfo, averageRating, numberOfReviews, imageInfo | slug can be any string |34| getProductPricing | focused pricing info | itemId ← searchProducts | currentPrice, wasPrice, savingsAmount, isPriceReduced | subset of product detail |35| addToCart | add product to cart | usItemId ← searchProducts, quantity | cartId, cartCount, item | ⚠️ write op, adapter-based |36| removeFromCart | remove product from cart | usItemId ← addToCart / searchProducts | cartId, cartCount, removedItemId | ⚠️ write op; idempotent — adapter seeds qty=1 via updateItems before removal so a fresh `usItemId` works without a prior addToCart |3738## Known Limitations39- **Cart write ops require open walmart.com tab in the managed browser.** The adapter posts persisted GraphQL mutations from the page context.40- **PerimeterX rate-limits cart calls.** Repeated addToCart/removeFromCart bursts return HTTP 429 from `/orchestra/{cartxo,home}/graphql/*` for ≥1 h. Wait or rotate network/profile to recover; no code change needed.4142## Quick Start4344```bash45# Search for products46openweb walmart exec searchProducts '{"q": "laptop"}'4748# Get full product detail (slug can be any non-empty string)49openweb walmart exec getProductDetail '{"slug": "item", "itemId": "5113175776"}'5051# Get focused pricing52openweb walmart exec getProductPricing '{"itemId": "5113175776"}'5354# Add to cart (requires browser page on walmart.com)55openweb walmart exec addToCart '{"usItemId": "5113175776", "quantity": 1}'5657# Remove from cart (requires browser page on walmart.com)58openweb walmart exec removeFromCart '{"usItemId": "5113175776"}'59```
spike-faye-lei