feat: Add return/replace items functionality

[davidvasandani]

Summary

• Adds the ability to initiate returns or replacements for Amazon orders
• Implements a new MCP tool initiate-return that navigates to Amazon's return page
• Extracts and displays returnable items with their eligibility status

Changes

1. Order History Enhancement:

   • Added returnUrl field to each order in order history
   • URL follows format: https://www.amazon.com/spr/returns/cart?orderId=XXX&ref=ppx_yo2ov_dt_b_return_replace

2. New MCP Tool:

   • initiate-return: Accepts an order ID and navigates to the return page
   • Returns information about returnable items including title, price, and eligibility

3. Return Page Scraping:

   • Properly detects the return page by checking for "Choose items to return" heading
   • Extracts item details from checkboxes and associated elements
   • Handles error cases when orders are not eligible for returns

Test Results

Successfully tested with real Amazon orders:

• ✅ Navigates to return page correctly
• ✅ Extracts all returnable items (tested with 6 items)
• ✅ Shows item details: title, price, order number
• ✅ Correctly identifies return eligibility status

Usage

// Get order history first
const orders = await getOrdersHistory()
// Each order now has a returnUrl field

// Initiate return for a specific order
const result = await initiateReturn('114-3824678-7026645')
// Returns list of returnable items with eligibility status

🤖 Generated with Claude Code