Amazon
Overview
E-commerce marketplace — search products, view details, read reviews, browse deals, manage cart.
Workflows
Search and view product details
searchProducts(k) → product list with asingetProductDetail(asin) → full product info (name, price, brand, rating)getProductReviews(asin) → customer reviews
Browse deals
searchDeals(startIndex, pageSize) → deal products with pricing and badgesgetProductDetail(asin) ← asin from deal product → full product info
Discover trending products
getBestSellers → ranked best-selling products
Cart operations
searchProducts(k) → asinaddToCart(asin) → cartCount, subtotalgetCart → cart items with asin, title, quantity, subtotalremoveFromCart(asin ← getCart) → updated cart
Operations
| Operation |
Intent |
Key Input |
Key Output |
Notes |
| searchProducts |
search products by keyword |
k (query) |
asin, title, price, rating |
entry point; paginated (page param) |
| getProductDetail |
view full product info |
asin ← searchProducts |
name, price, brand, description, rating, reviewCount |
DOM selector extraction |
| getProductReviews |
read customer reviews |
asin ← searchProducts |
rating, title, body, author, date |
paginated (pageNumber); sortBy: recent/helpful |
| searchDeals |
browse active deals |
startIndex, pageSize |
asin, title, price, dealBadge, percentClaimed |
JSON API; paginated (nextIndex) |
| getBestSellers |
view best sellers |
— |
title, price, rating, link |
entry point |
| addToCart |
add product to cart |
asin ← searchProducts, quantity? |
success, cartCount, subtotal |
write op; clicks Add to Cart, verifies via cart JSON API |
| removeFromCart |
remove product from cart |
asin ← getCart |
success, cartCount, subtotal |
write op; reverse of addToCart; clicks Delete in cart |
| getCart |
view cart contents |
— |
items (asin, title, price, quantity), subtotal |
JSON API + DOM enrichment |
Quick Start
# Search for products
openweb amazon exec searchProducts '{"k": "laptop"}'
# Get product details by ASIN
openweb amazon exec getProductDetail '{"asin": "B00MVWGQX0"}'
# Get product reviews
openweb amazon exec getProductReviews '{"asin": "B00MVWGQX0"}'
# Browse current deals
openweb amazon exec searchDeals '{"startIndex": 1, "pageSize": 20}'
# View best sellers
openweb amazon exec getBestSellers '{}'
# Add product to cart
openweb amazon exec addToCart '{"asin": "B00MVWGQX0"}'
# Remove product from cart
openweb amazon exec removeFromCart '{"asin": "B00MVWGQX0"}'
# View cart
openweb amazon exec getCart '{}'
1---2name: amazon3description: Amazon4---5# Amazon67## Overview8E-commerce marketplace — search products, view details, read reviews, browse deals, manage cart.910## Workflows1112### Search and view product details131. `searchProducts(k)` → product list with `asin`142. `getProductDetail(asin)` → full product info (name, price, brand, rating)153. `getProductReviews(asin)` → customer reviews1617### Browse deals181. `searchDeals(startIndex, pageSize)` → deal products with pricing and badges192. `getProductDetail(asin)` ← asin from deal product → full product info2021### Discover trending products221. `getBestSellers` → ranked best-selling products2324### Cart operations251. `searchProducts(k)` → `asin`262. `addToCart(asin)` → `cartCount`, `subtotal`273. `getCart` → cart items with `asin`, `title`, `quantity`, `subtotal`284. `removeFromCart(asin ← getCart)` → updated cart2930## Operations3132| Operation | Intent | Key Input | Key Output | Notes |33|-----------|--------|-----------|------------|-------|34| searchProducts | search products by keyword | k (query) | asin, title, price, rating | entry point; paginated (page param) |35| getProductDetail | view full product info | asin ← searchProducts | name, price, brand, description, rating, reviewCount | DOM selector extraction |36| getProductReviews | read customer reviews | asin ← searchProducts | rating, title, body, author, date | paginated (pageNumber); sortBy: recent/helpful |37| searchDeals | browse active deals | startIndex, pageSize | asin, title, price, dealBadge, percentClaimed | JSON API; paginated (nextIndex) |38| getBestSellers | view best sellers | — | title, price, rating, link | entry point |39| addToCart | add product to cart | asin ← searchProducts, quantity? | success, cartCount, subtotal | write op; clicks Add to Cart, verifies via cart JSON API |40| removeFromCart | remove product from cart | asin ← getCart | success, cartCount, subtotal | write op; reverse of addToCart; clicks Delete in cart |41| getCart | view cart contents | — | items (asin, title, price, quantity), subtotal | JSON API + DOM enrichment |4243## Quick Start4445```bash46# Search for products47openweb amazon exec searchProducts '{"k": "laptop"}'4849# Get product details by ASIN50openweb amazon exec getProductDetail '{"asin": "B00MVWGQX0"}'5152# Get product reviews53openweb amazon exec getProductReviews '{"asin": "B00MVWGQX0"}'5455# Browse current deals56openweb amazon exec searchDeals '{"startIndex": 1, "pageSize": 20}'5758# View best sellers59openweb amazon exec getBestSellers '{}'6061# Add product to cart62openweb amazon exec addToCart '{"asin": "B00MVWGQX0"}'6364# Remove product from cart65openweb amazon exec removeFromCart '{"asin": "B00MVWGQX0"}'6667# View cart68openweb amazon exec getCart '{}'69```
spike-faye-lei