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.