woolworths_add_to_cart
Add products to your Woolworths shopping cart using product stockcodes. Specify quantity to manage your online grocery items for checkout.
Instructions
Add a product to the shopping cart/trolley
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stockcode | Yes | The product stockcode/ID to add | |
| quantity | No | Quantity to add (default: 1) |
Implementation Reference
- src/index.ts:460-498 (handler)The handler function that executes the tool logic: adds the specified product (by stockcode) and quantity to the Woolworths shopping cart by posting to the trolley update API endpoint.
async function handleAddToCart(args: any): Promise<any> { const stockcode = args.stockcode; const quantity = args.quantity ?? 1; const url = `https://www.woolworths.com.au/api/v3/ui/trolley/update`; try { const data = await makeWoolworthsRequest(url, { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify({ items: [ { stockcode, quantity, source: "ProductDetail", diagnostics: "0", searchTerm: null, evaluateRewardPoints: false, offerId: null, profileId: null, priceLevel: null, }, ], }), }); return { success: true, cart: data, }; } catch (error: any) { return { success: false, error: error.message, }; } } - src/index.ts:144-161 (registration)Registration of the tool in the TOOLS array used for listing tools, including name, description, and input schema.
name: "woolworths_add_to_cart", description: "Add a product to the shopping cart/trolley", inputSchema: { type: "object", properties: { stockcode: { type: "number", description: "The product stockcode/ID to add", }, quantity: { type: "number", description: "Quantity to add (default: 1)", default: 1, }, }, required: ["stockcode"], }, }, - src/index.ts:655-657 (registration)Registration/dispatch of the tool handler in the main switch statement for tool calls.
case "woolworths_add_to_cart": result = await handleAddToCart(args || {}); break; - src/index.ts:210-248 (helper)Supporting utility function to perform authenticated fetch requests to Woolworths APIs, using session cookies; called by the add-to-cart handler.
async function makeWoolworthsRequest( url: string, options: any = {} ): Promise<any> { if (sessionCookies.length === 0) { throw new Error( "No session cookies available. Please use woolworths_get_cookies first." ); } const headers = { "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36", Accept: "*/*", "Accept-Language": "en-US,en;q=0.9", Origin: "https://www.woolworths.com.au", Referer: "https://www.woolworths.com.au/", "sec-fetch-dest": "empty", "sec-fetch-mode": "cors", "sec-fetch-site": "same-origin", Priority: "u=1, i", Cookie: getCookieHeader(), ...options.headers, }; const response = await fetch(url, { ...options, headers, }); if (!response.ok) { const errorText = await response.text(); throw new Error( `API request failed: ${response.status} ${response.statusText}. ${errorText}` ); } return response.json(); }