🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Amazon Shopper

by @brennerspear

Buy and return items on Amazon using browser automation. Use for purchasing, reordering, checking order history, and processing returns.

Versionv1.0.0
Downloads1,405
Installs4
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
  • Chrome running with --remote-debugging-port=9222 (see Starting the browser)
  • Logged into Amazon β€” if logged out, retrieve password from your password manager
  • If running headless (Linux/VNC), forward the VNC port to verify visually: ssh -L 6080:localhost:6080 β†’ http://localhost:6080/vnc.html
  • Setup

    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)

  • Return reason: "Changed Mind" β†’ "My needs changed"
  • Packaging opened: Yes
  • Item in original packaging: Yes
  • Have you used the item: Yes
  • Signs of use: None
  • Battery leaks/overheating: No
  • All accessories included: Yes
  • Refund type: Refund to original payment method (not replacement, not gift card)
  • Drop-off location: Use AMAZON_RETURN_DROPOFF or Whole Foods
  • Return 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 emailed

    Communication Style

  • Do NOT narrate each step β€” just execute the whole return silently
  • Only message the user once it's confirmed with a brief summary:
  • - Item name - Refund amount - Drop-off location & deadline
  • If something goes wrong or needs clarification, then ask
  • Ordering Rules

    Reorders (items ordered before)

  • Go directly to order history, search for item
  • Click "Buy it again"
  • Verify address and payment method
  • Place order without confirmation β€” no screenshot needed
  • New Items (never ordered before)

  • Search or navigate to product
  • Send screenshot of product page (scroll so price + product image visible, skip nav bars)
  • Wait for user confirmation before adding to cart
  • Verify address and payment method
  • Place order after confirmation
  • 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

  • Scroll past nav bars before screenshotting
  • Ensure price and product image are both visible
  • Save screenshots to a temporary directory
  • Send via message tool with caption
  • 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

  • Browser profile persists login at $HOME/.config/chrome-agent
  • On headless Linux, VNC display is typically :99 on port 5999 (noVNC on 6080)
  • Order confirmations go to the email on your Amazon account
  • CAPTCHAs or 2FA may require manual intervention β€” if the browser window is visible (macOS or Linux desktop), ask the user to solve it in the Chrome window
  • βš™οΈ 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

  • Browser profile persists login at $HOME/.config/chrome-agent
  • On headless Linux, VNC display is typically :99 on port 5999 (noVNC on 6080)
  • Order confirmations go to the email on your Amazon account
  • CAPTCHAs or 2FA may require manual intervention β€” if the browser window is visible (macOS or Linux desktop), ask the user to solve it in the Chrome window