cli-web-amazon
Read-only Amazon browsing: search, product detail, Best Sellers, suggestions. Public endpoints only.
Install: pip install cli-web-amazon
Commands
search QUERY — search products by keyword. Options: --page N (default 1, typically 1–7 pages), --dept TEXT (e.g. electronics, books)product get ASIN — full detail for one product (10-char ASIN, e.g. B0GRZ78683)bestsellers [CATEGORY] — Best Sellers list (default category: electronics; others: books, toys-and-games, music, video-games, home-garden, clothing-shoes-jewelry, sports-outdoors, kitchen, beauty). Options: --page N (~50 items/page)suggest QUERY — autocomplete suggestions. Options: --limit N (default 11)
Examples
# Search — returns [{asin, title, price, rating, review_count, url}]
cli-web-amazon search "wireless headphones" --json
# Search → detail on top result
ASIN=$(cli-web-amazon search "headphones" --json | python3 -c "import json,sys; print(json.load(sys.stdin)[0]['asin'])")
cli-web-amazon product get "$ASIN" --json
# Top best sellers in a category — [{rank, asin, title, price, url}]
cli-web-amazon bestsellers books --json
# Autocomplete — [{value, type}]
cli-web-amazon suggest "iphone ca" --json
JSON output
Add --json for structured output. Success responses are bare arrays (search, bestsellers, suggest) or a bare object (product get). Errors: {"error": true, "code": "NOT_FOUND|RATE_LIMITED|NETWORK_ERROR|SERVER_ERROR", "message": "..."}.
Utilities
cli-web-amazon doctor [--json] diagnoses local setup. cli-web-amazon mcp-serve exposes the commands as MCP tools over stdio. Running with no subcommand opens an interactive REPL.
Agent tips
- Search-result
price can be empty (Amazon renders some prices client-side). Use product get for reliable pricing; its price_note explains a missing price, and geo_restricted flags region-locked items.
1---2name: amazon-cli3description: Searches Amazon from the terminal via cli-web-amazon — product search, product details by ASIN, Best Sellers by category, and autocomplete suggestions. Use when the user asks about Amazon products, prices, best sellers, or wants to search Amazon. Prefer cli-web-amazon over fetching the website. No auth required.4---56# cli-web-amazon78Read-only Amazon browsing: search, product detail, Best Sellers, suggestions. Public endpoints only.9Install: `pip install cli-web-amazon`1011## Commands1213- `search QUERY` — search products by keyword. Options: `--page N` (default 1, typically 1–7 pages), `--dept TEXT` (e.g. electronics, books)14- `product get ASIN` — full detail for one product (10-char ASIN, e.g. `B0GRZ78683`)15- `bestsellers [CATEGORY]` — Best Sellers list (default category: electronics; others: books, toys-and-games, music, video-games, home-garden, clothing-shoes-jewelry, sports-outdoors, kitchen, beauty). Options: `--page N` (~50 items/page)16- `suggest QUERY` — autocomplete suggestions. Options: `--limit N` (default 11)1718## Examples1920```bash21# Search — returns [{asin, title, price, rating, review_count, url}]22cli-web-amazon search "wireless headphones" --json2324# Search → detail on top result25ASIN=$(cli-web-amazon search "headphones" --json | python3 -c "import json,sys; print(json.load(sys.stdin)[0]['asin'])")26cli-web-amazon product get "$ASIN" --json2728# Top best sellers in a category — [{rank, asin, title, price, url}]29cli-web-amazon bestsellers books --json3031# Autocomplete — [{value, type}]32cli-web-amazon suggest "iphone ca" --json33```3435## JSON output3637Add `--json` for structured output. Success responses are bare arrays (search, bestsellers, suggest) or a bare object (product get). Errors: `{"error": true, "code": "NOT_FOUND|RATE_LIMITED|NETWORK_ERROR|SERVER_ERROR", "message": "..."}`.3839## Utilities4041`cli-web-amazon doctor [--json]` diagnoses local setup. `cli-web-amazon mcp-serve` exposes the commands as MCP tools over stdio. Running with no subcommand opens an interactive REPL.4243## Agent tips4445- Search-result `price` can be empty (Amazon renders some prices client-side). Use `product get` for reliable pricing; its `price_note` explains a missing price, and `geo_restricted` flags region-locked items.
ItamarZand88