feat(amazon-shopping): scaffold amazon product search skill

2026-04-15 18:24:13 -05:00
parent 26a968797c
commit 8ad532545d
14 changed files with 1234 additions and 0 deletions
@@ -0,0 +1,38 @@
+---
+name: amazon-shopping
+description: Search amazon.com shopping results with product filters using the local web-automation skill. Use when the user asks to find, compare, filter, or summarize Amazon products by description, price, delivery, specs, review count, star rating, or star distribution.
+---
+
+# Amazon Shopping
+
+Use this skill for read-only Amazon product discovery and comparison.
+
+## First Checks
+
+Verify the browser dependency before live use:
+
+```bash
+openclaw skills info web-automation
+cd ~/.openclaw/workspace/skills/web-automation/scripts
+node check-install.js
+```
+
+## Search Products
+
+Run the helper from the installed skill directory:
+
+```bash
+cd ~/.openclaw/workspace/skills/amazon-shopping
+scripts/search-products "<user request>" --json
+```
+
+Default to at most 15 products unless the user asks for a different count. For requested counts above 30, ask before continuing or split the request into batches. Always include source URLs, report missing fields explicitly, and do not claim review histogram data unless it was visible and extracted.
+
+## Guardrails
+
+This skill is for operator-directed, read-only product research. Before live scraping, the helper checks Amazon robots directives for planned paths. Do not automate sign-in, cart, purchase, wishlist, review submission, review-page crawling, CAPTCHA bypass, or blocked-page bypass. If Amazon returns a challenge or block page, stop and report that status.
+
+Read references when needed:
+- `references/amazon-data-map.md` for fields and selectors.
+- `references/web-automation-prompts.md` for browser extraction prompts.
+- `references/compliance-and-failure-modes.md` for blocked-page and unknown-field behavior.