π¦ ClawHub
Amazon Shopper
by @brennerspear
Buy and return items on Amazon using browser automation. Use for purchasing, reordering, checking order history, and processing returns.
TERMINAL
clawhub install amazon-shopperπ About This Skill
name: amazon description: Buy and return items on Amazon using browser automation. Use for purchasing, reordering, checking order history, and processing returns. compatibility: Requires agent-browser CLI with Chrome DevTools Protocol (CDP). Chrome must be running with --remote-debugging-port. Optional VNC for headless setups.
Amazon Ordering
Prerequisites
agent-browser CLI installed--remote-debugging-port=9222 (see Starting the browser)ssh -L 6080:localhost:6080 β http://localhost:6080/vnc.htmlSetup
Set these environment variables or configure your defaults:
# Your default shipping address (verify on checkout)
export AMAZON_SHIPPING_ADDRESS="Your shipping address"
Your preferred payment method description (verify on checkout)
export AMAZON_PAYMENT_METHOD="Your preferred card"
Your preferred return drop-off location
export AMAZON_RETURN_DROPOFF="Whole Foods"
Always verify shipping address and payment method are correct before placing an order.
Returns
Default Answers (use unless user specifies otherwise)
AMAZON_RETURN_DROPOFF or Whole FoodsReturn Flow
1. Orders β Find item β "Return or replace items" 2. Select "Changed Mind" β "My needs changed" β Continue 3. Answer condition questions with defaults above 4. Continue past "Get Product Support" suggestions 5. Select "Refund to original payment method" 6. Select drop-off location 7. Confirm return 8. Done β QR code will be emailedCommunication Style
Ordering Rules
Reorders (items ordered before)
New Items (never ordered before)
Workflow
Connect to browser
agent-browser connect 9222
Always open a new tab β other sessions share the same Chrome. Use --new-tab on every open command.
Search order history
agent-browser open "https://www.amazon.com/gp/your-account/order-history"
agent-browser snapshot -i
Find search box, fill with item name, click search
Reorder flow
# From order history search results
agent-browser click @[buy-it-again-ref]
Wait for checkout page
agent-browser snapshot
Verify correct address and payment method are selected
agent-browser click @[place-order-ref]
Screenshot tips
Starting the browser (if not running)
macOS (opens a visible Chrome window):
open -na "Google Chrome" --args --user-data-dir=$HOME/.config/chrome-agent --no-first-run --remote-debugging-port=9222 https://www.amazon.com
Linux (headless with Xvfb/VNC):
DISPLAY=:99 google-chrome --user-data-dir=$HOME/.config/chrome-agent --no-first-run --remote-debugging-port=9222 https://www.amazon.com &
Linux (desktop/GUI session):
google-chrome --user-data-dir=$HOME/.config/chrome-agent --no-first-run --remote-debugging-port=9222 https://www.amazon.com &
Notes
$HOME/.config/chrome-agent:99 on port 5999 (noVNC on 6080)βοΈ Configuration
Set these environment variables or configure your defaults:
# Your default shipping address (verify on checkout)
export AMAZON_SHIPPING_ADDRESS="Your shipping address"
Your preferred payment method description (verify on checkout)
export AMAZON_PAYMENT_METHOD="Your preferred card"
Your preferred return drop-off location
export AMAZON_RETURN_DROPOFF="Whole Foods"
Always verify shipping address and payment method are correct before placing an order.
π Tips & Best Practices
$HOME/.config/chrome-agent:99 on port 5999 (noVNC on 6080)