Amazon research

Reduck scripts that turn Amazon US flows into callable building blocks. Each script below is a pointer — read its contract (read_script) for the exact args and output. They run against handle:"reduck", host:"amazon.com". The skill only runs these published scripts; it never writes or publishes a script.

Amazon is US-only here: pass zipCode (default 10001) so price and availability match a US locale. get-product-reviews is loggedIn:true — it needs an Amazon session exposed via reduck local --cookies (see the reduck skill for the bridge lifecycle and how to run a script). The other three are public, no login.

Scripts

• @reduck/amazon.com/search-products — (query, page?, zipCode?) → listings {asin, title, price, list_price, rating, review_count, image_url, sponsored}. ~16-22 organic results/page, cap ~20 pages. No seller rating or bulk tiers (not on the search page). The entry point for "find / price a product".
• @reduck/amazon.com/get-product — (asin, zipCode?) → full listing: price, list_price, rating, review_count, rating_breakdown (% per star), seller, availability, feature_bullets, variant_asins, etc. list_price / seller / breadcrumb are sometimes null — treat null as "not exposed", not zero.
• @reduck/amazon.com/get-product-reviews — (asin, page?, sortBy?(recent|helpful), filterByStar?, reviewerType?, mediaType?, filterByKeyword?, zipCode?) → product{…, starBreakdown} + reviews[]. loggedIn:true (bridge --cookies). 10 reviews/page, cap 10 pages. For N pages, call page 1..N and concatenate.
• @reduck/amazon.com/list-category — (url, zipCode?) where url MUST match ^https://www.amazon.com/s?… → {heading, products:[{asin, position, sponsored}]}. Card-level only (no price/rating) → chain into get-product. Does NOT accept /gp/bestsellers — so "best-sellers" is approximated by a search-results URL, not the real Best Sellers chart.