Back to Details

amazon

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Amazon Ordering

Amazon订单处理

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 <host>
    → http://localhost:6080/vnc.html
  • 已安装
    agent-browser
    CLI
  • Chrome以
    --remote-debugging-port=9222
    参数运行（参见【启动浏览器（若未运行）】章节）
  • 已登录Amazon账号——若已登出，请从密码管理器中获取密码
  • 若以无头模式运行（Linux/VNC），需转发VNC端口以可视化验证：
    ssh -L 6080:localhost:6080 <host>
    → 访问http://localhost:6080/vnc.html

Setup

设置

Set these environment variables or configure your defaults:
bash
undefined
设置以下环境变量或配置默认值：
bash
undefined

Your default shipping address (verify on checkout)

你的默认收货地址（结账时请验证）

export AMAZON_SHIPPING_ADDRESS="Your shipping address"
export AMAZON_SHIPPING_ADDRESS="Your shipping address"

Your preferred payment method description (verify on checkout)

你偏好的支付方式描述（结账时请验证）

export AMAZON_PAYMENT_METHOD="Your preferred card"
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.
export AMAZON_RETURN_DROPOFF="Whole Foods"

下单前请务必确认收货地址和支付方式正确无误。

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
  • 退换原因："Changed Mind" → "我的需求发生了变化"
  • 包装是否已打开：是
  • 商品是否在原包装内：是
  • 是否使用过该商品：是
  • 使用痕迹：无
  • 电池是否泄漏/过热：否
  • 所有配件是否齐全：是
  • 退款类型：退回原支付方式（不更换商品，不退款至礼品卡）
  • 投递点：使用
    AMAZON_RETURN_DROPOFF
    配置的值或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
  1. 订单页面 → 找到对应商品 → 点击"Return or replace items"
  2. 选择"Changed Mind" → "我的需求发生了变化" → 继续
  3. 使用上述默认回复回答商品状态相关问题
  4. 跳过"Get Product Support"建议，继续操作
  5. 选择"退回原支付方式"
  6. 选择投递点
  7. 确认退换货
  8. 完成——二维码将通过邮件发送

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
  • 直接进入订单历史页面，搜索对应商品
  • 点击"Buy it again"
  • 验证收货地址和支付方式
  • 无需确认即可下单——无需截图

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.
bash
agent-browser connect 9222
始终打开新标签页——其他会话共享同一Chrome实例。每次使用
open
命令时添加
--new-tab
参数。

Search order history

搜索订单历史

bash
agent-browser open "https://www.amazon.com/gp/your-account/order-history"
agent-browser snapshot -i
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

找到搜索框，填入商品名称，点击搜索

undefined
undefined

Reorder flow

重新下单流程

bash
undefined
bash
undefined

From order history search results

从订单历史搜索结果中

agent-browser click @[buy-it-again-ref]
agent-browser click @[buy-it-again-ref]

Wait for checkout page

等待结账页面加载

agent-browser snapshot
agent-browser snapshot

Verify correct address and payment method are selected

确认已选中正确的收货地址和支付方式

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

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 &
macOS（打开可见的Chrome窗口）：
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（使用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（桌面/GUI会话）：
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
  • 浏览器配置文件会在
    $HOME/.config/chrome-agent
    路径下保存登录状态
  • 在Linux无头模式下，VNC显示通常为
    :99
    ，端口5999（noVNC端口6080）
  • 订单确认邮件将发送至你的Amazon账号绑定邮箱
  • CAPTCHA或双因素认证可能需要手动干预——若浏览器窗口可见（macOS或Linux桌面环境），请让用户在Chrome窗口中完成验证