Amazon Shopping Skill

amazon-shopping searches Amazon.com product results with bounded, read-only web automation and deterministic local filtering.

Example Invocation

use amazon-shopping to search for 100w led bulbs that cost less than $4 each and have over 200 reviews with a review score of more than 4.5 stars

Helper Commands

Run from the installed skill:

cd ~/.openclaw/workspace/skills/amazon-shopping
scripts/search-products 'USB-C charger under $30' --limit 10 --json
scripts/search-products '100w led bulbs that cost less than $4 each and have over 200 reviews with a review score of more than 4.5 stars' --limit 5 --markdown
scripts/search-products 'USB-C cable with over 1000 reviews and rating over 4 stars' --limit 3 --json --skip-details

Use --dry-run to parse a request and show planned filters without navigating to Amazon:

scripts/search-products 'USB-C charger under $30' --dry-run --json

Use single quotes when a request contains dollar amounts so the shell does not expand $4. --max N is accepted as a compatibility alias for --limit N.

Install Or Update

Run these commands from the stef-openclaw-skills repo checkout:

cd ~/.openclaw/workspace/projects/stef-openclaw-skills
git pull --ff-only
rsync -a --delete \
  --exclude node_modules \
  --exclude dist \
  --exclude coverage \
  --exclude tmp \
  --exclude out \
  --exclude '*.log' \
  --exclude '*.real.html' \
  skills/amazon-shopping/ \
  ~/.openclaw/workspace/skills/amazon-shopping/
cd ~/.openclaw/workspace/skills/amazon-shopping
npm ci

Use the same sequence for a first install and for updates. rsync --delete keeps the active skill identical to the repo copy while preserving generated dependencies through the node_modules exclude. Always run npm ci after syncing because dependency changes are tracked through package-lock.json.

Setup Verification

Verify the dependency skill, the active install, and OpenClaw discovery:

openclaw skills info web-automation
node "$HOME/.openclaw/workspace/skills/web-automation/scripts/check-install.js"
cd ~/.openclaw/workspace/skills/amazon-shopping
npm run lint
npm run typecheck
npm test
openclaw skills info amazon-shopping

For a quick parser-only check that does not browse Amazon:

scripts/search-products 'USB-C charger under $30' --dry-run --json

For a live smoke after install or update:

scripts/search-products '100w led bulbs that cost less than $4 each and have over 200 reviews with a review score of more than 4.5 stars' --limit 5 --json

Dependency

This skill depends on the workspace web-automation skill and its CloakBrowser runtime.

Fields

Each result includes the product ASIN, title, source URL, price, unit price when visible, rating, review count, delivery summary, specs, feature bullets, seller, availability, sponsored marker, matched filters, missing fields, and extraction notes.

Unknown or hidden fields stay unknown. The skill does not invent delivery dates, star histograms, prices, or review counts.

Filters

Supported request filters include:

minimum rating
minimum review count
maximum product price
maximum unit price
result limit
maximum search pages

over 200 reviews and more than 4.5 stars are strict comparisons. at least 200 reviews and 4.5 stars or better are inclusive comparisons.

Guardrails

This skill is for operator-directed product research, not purchasing automation.

It checks Amazon robots directives before live navigation.
It does not sign in, add to cart, purchase, access wishlists, submit reviews, crawl review pages, or bypass CAPTCHA/block pages.
It stops and reports a warning when Amazon returns a challenge, block, or disallowed robots path.
It uses default bounded operation: 15 results, 2 search pages, detail pages one at a time.

3.8 KiB Raw Blame History