Files
stef-openclaw-skills/skills/amazon-shopping/references/web-automation-prompts.md
T

1.8 KiB

Web-Automation Prompts

Use these patterns when debugging or extending the amazon-shopping browser workflow. The TypeScript helper is the default interface; these prompts document the intended rendered-page behavior.

Search Page

Use the installed web-automation skill. Open https://www.amazon.com/s?k=<encoded query>. Wait for rendered search results. If a CAPTCHA, bot check, sign-in wall, or access denied page appears, stop and return a challenge status. Otherwise extract visible product cards with ASIN, title, product URL, displayed price, rating text, review count text, delivery text, sponsor marker, and image URL. Do not open cart, sign-in, wishlist, or review-listing pages.

Detail Page

For each candidate product detail URL under /dp/<ASIN> or /gp/product/<ASIN>, open the page slowly one at a time. Extract title, canonical link, visible buy-box/current price, delivery summary, availability, seller when visible, feature bullets, product details/specification table rows, rating score, review count, and visible customer-review histogram percentages if present on the detail page. Do not navigate to /product-reviews or reviewer profile pages.

Pagination

Follow only the visible Amazon pagination control for the next search page, or construct page=<n> only after the current page exposes normal search results and no challenge/block. Stop when enough candidates have been collected, no next page exists, a challenge appears, or maxSearchPages is reached.

Robustness Notes

  • Prefer Playwright locator/actionability behavior and bounded waits over fixed sleeps.
  • Never follow sponsored redirect URLs, sign-in links, cart links, wishlist links, or review-page links.
  • Return partial results with warnings when Amazon markup changes or fields are hidden.