eBay for AI Agents

Discovery starts with search_products, which takes a keyword query and navigates by URL for reliability, or with browse_category, which opens eBay's all-categories directory. On a results page the agent can sort with sort_results, page with next_page and prev_page, and refine by facet with filter_results. To inspect an item it calls view_product with the listing title or a distinctive substring of it.

From a listing's detail page the agent can add_to_cart, start a buy_it_now checkout on a fixed-price listing, open the make_offer dialog on Best Offer listings, or save_to_watchlist. Signed in, it can also work the account side: purchase history, per-order detail, shipment tracking via track_order, saved addresses, and saved payment methods.

eBay's filter set is dynamic. The facets on a results page depend on the search and category (Condition, Brand, Buying Format, and so on), so the config ships list_available_filters_search_results: call it on the current results page first, then pass a real filter_name and value to filter_results. Never assume a fixed facet set.

make_offer only works on Best Offer listings; on anything else the dialog does not exist. Cart building is public but buying is not: add_to_cart needs no account, while checkout requires sign-in and buy_it_now leads straight to the sign-in / checkout gate. And order actions are name-addressed: track_order and view_order_detail both take an order_name, so the agent picks the order from purchase history rather than guessing an ID.

Auth runs through eBay's real sign-in page at signin.ebay.com/signin/. The login action takes a username and password; if eBay challenges an unrecognized device, it emails a 6-digit verification code to the account address, and that code is entered in the Rindler Connect form to complete the sign-in.

You only need it for the flows that are personal. 10 of the 22 actions require sign-in: checkout, buy_it_now, make_offer, the Watchlist pair, order history, order detail, tracking, and the saved-address and payment-method views. Everything on the search-and-browse surface, including the cart itself, works without an account.

Every step of an eBay session resolves to one of 9 named screens: landing, search_results, category, product_detail, cart, and sign_in on the public side, plus orders, watchlist, and account once signed in. That screen name anchors the session, so your agent always knows which surface it is on and which actions make sense there: paging and sorting belong to search_results, add_to_cart to product_detail, checkout to cart, track_order to orders. No selector guessing, no parsing raw HTML to figure out what page came back.