Skip to content

LeoYeAI/agent-master-skills / skills/amazon-checkout

amazon-checkout

Verified

Amazon Checkout - Use the new UCP search function from Shop App from Shopify."

FileKindSize
CHECKOUT-GUIDE.mdmarkdown6.8 KB
HEARTBEAT.mdmarkdown2.8 KB
MANAGEMENT.mdmarkdown2.5 KB
MY-STORE.mdmarkdown15.0 KB
SHOPPING-GUIDE.mdmarkdown7.7 KB
SKILL.mdskill md26.1 KB
STRIPE-X402-WALLET.mdmarkdown5.8 KB
WEBHOOK.mdmarkdown4.8 KB
_meta.jsonconfig464 B
agents/CLAUDE-PLUGIN.mdmarkdown1.7 KB
agents/OPENCLAW.mdmarkdown16.1 KB
amazon.mdmarkdown7.4 KB
amazon/AMAZON.mdmarkdown4.1 KB
amazon/_meta.jsonconfig760 B
bigcommerce/BIGCOMMERCE.mdmarkdown3.1 KB
bigcommerce/_meta.jsonconfig504 B
description.mdmarkdown522 B
generic/GENERIC.mdmarkdown4.6 KB
generic/_meta.jsonconfig476 B
heartbeat.mdmarkdown2.7 KB
magento/MAGENTO.mdmarkdown3.4 KB
magento/_meta.jsonconfig739 B
shopify/SHOPIFY.mdmarkdown9.1 KB
shopify/_meta.jsonconfig753 B
skill.jsonconfig1.2 KB
skill.mdmarkdown29.7 KB
squarespace/SQUARESPACE.mdmarkdown3.0 KB
squarespace/_meta.jsonconfig511 B
wix/WIX.mdmarkdown2.2 KB
wix/_meta.jsonconfig679 B
woocommerce/WOOCOMMERCE.mdmarkdown3.5 KB
woocommerce/_meta.jsonconfig666 B

amazon/AMAZON.md

View on GitHub
---
name: merchant-amazon
platform: amazon
updated: 2026-03-18
---

# Amazon — Merchant Guide

Amazon requires **account authentication** — no guest checkout. Uses saved payment methods and addresses from the account. No raw card entry at checkout.

> **Future:** CreditClaw will add Amazon API support (SP-API) once approved. For now, use browser control.

---

## Detection

```javascript
var isAmazon = (typeof ue !== 'undefined' && typeof AmazonUIPageJS !== 'undefined');
```

Other signals: `P` global, CDN hosts `images-na.ssl-images-amazon.com` and `m.media-amazon.com`, DOM elements `#twotabsearchtextbox`, `#nav-search-bar-form`, `#nav-logo-sprites`.

---

## Navigation

### URL Patterns

| Page | Pattern |
|------|---------|
| Search | `/s?k=<query>` |
| Product | `/dp/{ASIN}` (slug before `/dp/` is decorative) |
| Cart | `/gp/cart/view.html` |
| Sign-in | `/ap/signin` |
| Checkout | `/checkout/entry/cart` |

### Search Results (`/s?k=...`)

- Container: `[data-component-type="s-search-results"]`
- Each card: `[data-component-type="s-search-result"]` with `data-asin`
- Product link: `a[href*="/dp/"]` — **sponsored results may lack this** (use tracking redirects)
- Title: `h2 a span` | Price: `.a-price-whole` + `.a-price-fraction` | Prime: `.a-icon-prime`
- **No "Add to Cart" on search results** — must click into product page first

---

## Product Selection

### Product Page (`/dp/{ASIN}`)

| Element | Selector |
|---------|----------|
| ASIN | `#ASIN` (hidden input) or from URL |
| Title | `#productTitle` |
| Price | `#corePrice_feature_div` |
| Availability | `#availability` |
| Add to Cart | `#add-to-cart-button` |
| Buy Now | `#buy-now-button` (skips cart, goes to checkout) |
| Quantity | `#quantity` |

**Variants** live inside `#twister`. Common IDs: `#variation_color_name`, `#variation_size_name`, `#variation_style_name`. Not all products use these — some use button-style selectors. Snapshot the variant area rather than relying on fixed IDs.

**Add to Cart flow:** select variants → set quantity → click `#add-to-cart-button` → confirmation page at `/cart/smart-wagon?newItems=...` → navigate to `/gp/cart/view.html`.

### Cart (`/gp/cart/view.html`)

| Element | Selector |
|---------|----------|
| Cart items | `[data-asin][data-itemtype="active"]` |
| Subtotal | `#sc-subtotal-label-activecart` |
| Proceed to checkout | `[name="proceedToRetailCheckout"]` |
| Item quantity | `.sc-quantity-textfield` per item |
| Delete item | `[value="Delete"]` per item |

---

## Checkout

### Authentication

Amazon **always requires sign-in** before checkout.

**Sign-in flow:**
1. Email/phone field at `/ap/signin` → form posts to `/ax/claim` → click `#continue`
2. Password field on next page → `#ap_password` → click `#signInSubmit`

**Possible challenges:** CAPTCHA (`#auth-captcha-image`), OTP/2FA prompt, or "Approve sign-in" push notification to Amazon app. If any of these appear, escalate to the user.

**Session:** If already logged in, "Proceed to checkout" goes directly to checkout. Amazon sessions persist if "Keep me signed in" is checked. Check sign-in state via the nav bar text ("Hello, Sign in" vs "Hello, {Name}").

### Payment (Post-Authentication)

Amazon checkout uses **saved payment methods and addresses** — no raw card entry.

**Flow:** select shipping address → shipping speed → payment method → review → place order.

| Step | Selector |
|------|----------|
| Place order | `#submitOrderButtonId` or `[name="placeYourOrder1"]` |

The CreditClaw card must be **already added to the Amazon account**. The agent selects it at checkout by last 4 digits, confirms address and shipping speed, then clicks "Place your order".

---

## Tips & Pitfalls

1. **Don't scan full pages** — Amazon pages are massive. Use targeted selectors (`#add-to-cart-button`, `#productTitle`) instead of full snapshots.
2. **ASIN is king** — use `/dp/{ASIN}` for direct product navigation.
3. **Skip sponsored results** — they use tracking redirects instead of clean `/dp/` links.
4. **Watch for CAPTCHA** — Amazon may challenge automation. Escalate to user if it appears.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall