AugmentClaude

Amazon CLI

Search Amazon products, prices, and best sellers from the command line.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.

    This copies the whole skill folder into ~/.claude/skills/amazon-cli-itamarzand88/ — the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

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.

What this skill does

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.

Related skills