✓ Verified 🌐 Web Scrapers ✓ Enhanced Data

Amazon Shopper

Buy and return items on Amazon using browser automation.

Rating: 4.4 (292 reviews)
Downloads: 1,963 downloads
Version: 1.0.0

Overview

Buy and return items on Amazon using browser automation.

Complete Documentation

View Source →

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:

bash

# 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

Orders → Find item → "Return or replace items"
Select "Changed Mind" → "My needs changed" → Continue
Answer condition questions with defaults above
Continue past "Get Product Support" suggestions
Select "Refund to original payment method"
Select drop-off location
Confirm return
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

bash

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

bash

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

bash

# 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):

bash

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):

bash

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):

bash

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

Installation

Terminal bash


openclaw install amazon-shopper

Copied!

💻Code Examples

export AMAZON_RETURN_DROPOFF="Whole Foods"

export-amazonreturndropoffwhole-foods.txt

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

agent-browser-connect-9222.txt

**Always open a new tab** — other sessions share the same Chrome. Use `--new-tab` on every `open` command.

### Search order history

agent-browser click @[place-order-ref]

agent-browser-click-place-order-ref.txt

### 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):

example.sh

# 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"

example.sh

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

example.sh

# 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]