cli-web-amazon

Search Amazon products, view details, browse Best Sellers, and get autocomplete suggestions. No authentication required.

Quick Start

cli-web-amazon search "laptop" --json
cli-web-amazon product get B0GRZ78683 --json
cli-web-amazon bestsellers electronics --json

Always use --json when parsing output programmatically.

Commands

search QUERY

Search Amazon products by keyword.

cli-web-amazon search "wireless headphones" --json
cli-web-amazon search "laptop" --page 2 --dept electronics --json

Key options: --page N (default 1), --dept <department>

Output fields: asin, title, price, rating, review_count, url

suggest QUERY

Autocomplete suggestions.

cli-web-amazon suggest "iphone case" --json

Output fields: value, type

product get ASIN

Full product detail by ASIN.

cli-web-amazon product get B0GRZ78683 --json

Output fields: asin, title, price, price_note, geo_restricted, rating, review_count, brand, image_url, url

bestsellers [CATEGORY]

Browse Amazon Best Sellers by category.

cli-web-amazon bestsellers electronics --json
cli-web-amazon bestsellers books --page 2 --json

Categories: electronics, books, toys-and-games, music, kitchen, clothing

Key options: --page N

Output fields: rank, asin, title, price, url

Agent Patterns

# Search then get full detail on top result
ASIN=$(cli-web-amazon search "headphones" --json | python -c "import json,sys; print(json.load(sys.stdin)[0]['asin'])")
cli-web-amazon product get "$ASIN" --json

# Top-5 bestsellers
cli-web-amazon bestsellers electronics --json | \
  python -c "import json,sys; [print(p['rank'], p['title'], p['price']) for p in json.load(sys.stdin)[:5]]"

# Autocomplete then search
cli-web-amazon suggest "wireles" --json | \
  python -c "import json,sys; print(json.load(sys.stdin)[0]['value'])"

Notes

• Auth: No authentication required — all commands work on public Amazon endpoints.
• Price: May be empty for some products (Amazon client-side renders prices). Use product get for reliable pricing; price_note explains why price is missing.
• ASIN: 10-character alphanumeric identifier (e.g. B0GRZ78683).
• Pagination: Search supports --page N (typically 1–7 pages). Best sellers supports --page N.
• Errors in --json mode: {"error": true, "code": "NOT_FOUND|RATE_LIMITED|NETWORK_ERROR|SERVER_ERROR", "message": "..."}
• Installation: pip install -e amazon/agent-harness