Site catalog

Walmart for AI Agents

walmart.com: 29 mapped actions across 4 screens

Walmart is one of the largest online retailers in the US, and its site was built for humans clicking through cards, filter sidebars, and variant pickers. Rindler maps that surface into deterministic actions, so your agent can search the catalog, narrow results, open product pages, build a cart, and run signed-in account flows without ever parsing raw HTML.

The Walmart config exposes 29 actions across 4 screens. Most of the shopping funnel is public: your agent can go from a keyword search to a loaded cart with no account at all. Signing in unlocks the account side, from checkout to order tracking, returns, addresses, and payment methods.

What is mapped

The core loop is search to cart. search_products takes a query and lands on the search results page. From there your agent can sort_results, apply sidebar facets with filter_results (a filter_name plus a value), and page through the grid with next_page and prev_page. view_product opens a product detail page by a distinctive substring of the product name, and add_to_cart puts the item in the basket. Cart management is fully mapped too: view_cart, update_quantity, and remove_from_cart all work on individual line items.

Beyond shopping, the config covers the signed-in account surface: checkout, promo codes, order tracking, cancellations, returns, order history and order detail, wishlists, loyalty status and point redemption, plus saved addresses and payment methods. There are also public utility actions like browsing categories, reading reviews, and finding stores with view_store_locator.

Quirks worth knowing

These come straight from the mapped action behavior, and your agent should plan around them.

  • **Walmart has two product card types.** Simple single-SKU products carry an Add to cart button directly on the search-result card, so add_to_cart works from the results grid. Variant products show an Options link instead: your agent must view_product first and pick options on the product detail page before adding to cart.
  • **Adding and quantity are separate verbs.** add_to_cart adds an item; any quantity change goes through update_quantity, which drives the same quantity spinbutton whether the item is on the product page or a cart line. remove_from_cart deletes the line entirely.
  • **Pagination is URL-driven.** Walmart paginates search results via a ?page={N} URL parameter at roughly 40 results per page, and next_page clicks the next-page button at the bottom of the grid. Budget for multiple pages on broad queries.
  • **Search navigates by URL, not by typing.** search_products uses URL-based navigation for reliability, so searches land directly on the results page instead of depending on the search box.

Signing in

Walmart sign-in is passwordless. The login action takes an email param: Walmart emails the account a 6-digit verification code, and the user enters that code in the Rindler Connect form. The mapped login URL is walmart.com/account/login, and Rindler handles the session from there.

You only need it for the account half of the catalog. 13 of the 29 actions require auth, including checkout, track_order, cancel_order, return_order, view_order_history, and the saved-address and payment-method actions account_addresses and account_payment_methods. Everything in the search-to-cart loop is public, so an agent can do product research and cart building anonymously and only prompt for sign-in when it is time to check out or touch the account.

Reading results

The config models Walmart as four screens: landing, search_results, product_detail, and cart. Every action lands your agent on one of them, and Rindler returns each screen as structured content rather than raw page markup.

A session starts on the landing screen. search_products moves to search_results, where filtering, sorting, and pagination keep you on the same screen with updated data. view_product moves to product_detail, which is also where variant products must be handled before adding to cart. view_cart moves to the cart screen, where quantity updates and removals operate per line item. Because the screen model is explicit, your agent always knows where it is and which actions apply next.

Example session

start_session(url: "https://www.walmart.com")

dispatch_action(action: "search_products", params: { query: "..." })
dispatch_action(action: "filter_results", params: { filter_name: "...", value: "..." })
dispatch_action(action: "view_product", params: { item: "..." })
dispatch_action(action: "add_to_cart", params: { item: "..." })
dispatch_action(action: "view_cart")

close_session()

Every mapped action

Generated from the live site config. 13 of 29 actions require a signed-in session.

ActionWhat it does
account_addressesauth
account_payment_methodsauth
add_to_cartAdd the current product to the cart. On the PDP, clicks button[aria-label='Add to cart']. From search results, can add simple (single-SKU) products directly using the card-level button[aria-label='Add to cart - {name}']. Variant products (showing an Options link instead) must be viewed on the PDP first. For cart-level updates use update_quantity.
apply_promoauth
browse_category
cancel_orderauth
capture_login
checkoutauth
filter_resultsApply a filter facet to narrow search results. Expands the target filter group in the left sidebar and checks the matching checkbox. Filter group header is a button; values are checkbox elements with aria-label containing the value and count.
loginSign in to Walmart (passwordless email code): enter your account email, Walmart emails a 6-digit verification code, and you enter it in the Rindler Connect form.
next_pageNavigate to the next page of search results. Walmart paginates via ?page={N} URL parameter (~40 results per page). Clicks the next-page button at the bottom of the result grid.
prev_pageNavigate to the previous page of search results.
redeem_pointsauth
remove_from_cartRemove an item from the Walmart cart entirely by clicking the Remove button near the matching item.
return_orderauth
save_to_wishlistauth
search_productsSearch for products on Walmart by keyword. Uses URL-based navigation for reliability. Lands on the search results page.
select_variant
sort_resultsSort search results by a specified criteria. Walmart uses a combobox or button-triggered menu near the result count header.
track_orderauth
update_quantityIncrease or decrease the quantity of an item on the PDP or in the cart. On the PDP use the spinbutton[aria-label='Quantity'] with Decrease/Increase quantity buttons. In the cart, the same quantity controls appear per line item.
view_cartNavigate to the Walmart shopping cart page.
view_loyalty_statusauth
view_order_detailauth
view_order_historyauth
view_productClick on a product card from search results to open its Product Detail Page (PDP). Pass a distinctive substring of the product name. NOTE: Walmart has two card types. Simple products have an Add to cart button directly on the card. Variant products show an Options link and require PDP navigation to select options before adding to cart.
view_reviews
view_store_locator
view_wishlistauth

Screens and structured records

  • cart returns structured fields, container records
  • landing (navigation screen)
  • product_detail (navigation screen)
  • search_results (navigation screen)