Forage Shopping

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• search_products

  Search for products across merchants and return comparison results. Returns structured product listings with prices, merchants, and checkout links. Searches Shopify's global catalogue (50M+ products

• compare_prices

  Compare prices for a specific product across multiple merchants. Finds the same product at different retailers and shows price differences.

• find_deals

  Find the best current deals in a product category. Searches for discounted, on-sale, or best-value products.

• start_checkout

  Start a UCP checkout session for a product. Discovers the merchant's UCP capabilities, creates a checkout session, and attaches content attribution data from the current session's search and comparis

• update_checkout_info

  Update a checkout session with buyer information. Provide the information the merchant requested (email, name, shipping address, discount codes). Call this after start_checkout when the merchant indi

• complete_purchase

  Complete a checkout and place the order. Only call this when the checkout status is 'ready_for_complete'. Records the purchase as a conversion in telemetry and ends the attribution session. Returns

• check_order

  Check the status of a checkout session or order. Use this after the user has completed an escalation step (e.g. payment in the browser) to see if the checkout can now proceed, or to check on a comple