28 lines
1.9 KiB
Markdown
28 lines
1.9 KiB
Markdown
# 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
|
|
|
|
```text
|
|
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, Prime badge/icon/aria/alt signal, sponsor marker, and image URL. Do not open cart, sign-in, wishlist, or review-listing pages.
|
|
```
|
|
|
|
## Detail Page
|
|
|
|
```text
|
|
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, Prime badge/icon/aria/alt signal, 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
|
|
|
|
```text
|
|
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.
|