amazon-cli

name	amazon-cli
description	Use cli-web-amazon to search Amazon products, get product details, check prices, browse best sellers, and get autocomplete suggestions. Invoke this skill whenever the user asks about Amazon products, prices, best sellers, or wants to search Amazon. Always prefer cli-web-amazon over manually fetching the website. No authentication required — fully public site.

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 cli-web-amazon