ShopSavvy CLI

Price comparison from your terminal. Search products, compare prices across retailers, track price history, and discover deals — all from the command line.

Install

Homebrew (macOS/Linux)

brew install shopsavvy/shopsavvy/shopsavvy

The fully qualified name taps shopsavvy/shopsavvy and trusts just this formula in one step, which Homebrew 6+ requires for third-party taps.

Download Binary

Grab the latest release from GitHub Releases for your platform.

From Source

git clone https://github.com/shopsavvy/shopsavvy-cli.git
cd shopsavvy-cli
bun install
bun run build
# Binary is at ./shopsavvy

Setup

# Save your API key
shopsavvy config set-key ss_live_your_key_here

# Or use an environment variable
export SHOPSAVVY_API_KEY=ss_live_your_key_here

Get your API key at shopsavvy.com/data.

Usage

Search for products

shopsavvy search "AirPods Pro"
shopsavvy search "Sony WH-1000XM5" --limit 5

Compare prices across retailers

# By ASIN
shopsavvy price B0D1XD1ZV3

# By barcode
shopsavvy price 194253392798

# Filter by retailer
shopsavvy price B0D1XD1ZV3 --retailer amazon

View price history

shopsavvy history B0D1XD1ZV3
shopsavvy history B0D1XD1ZV3 --days 90
shopsavvy history B0D1XD1ZV3 --days 365 --retailer amazon

Browse deals

shopsavvy deals
shopsavvy deals --sort new --limit 20
shopsavvy deals --sort top

Monitor prices

# Schedule monitoring
shopsavvy monitor B0D1XD1ZV3 --schedule hourly
shopsavvy monitor 194253392798 --schedule daily

# See what you're monitoring
shopsavvy monitored

# Stop monitoring
shopsavvy unmonitor B0D1XD1ZV3

Check API usage

shopsavvy usage

JSON output

Add --json to any command to get raw JSON output, useful for piping to jq:

shopsavvy search "iPhone 16" --json | jq '.data[0].name'
shopsavvy price B0D1XD1ZV3 --json | jq '.data[].offers | sort_by(.price)[0]'

Configuration

Your API key is stored at ~/.config/shopsavvy/config.json with restricted file permissions (600).

shopsavvy config set-key KEY   # Save API key
shopsavvy config show          # Show current config
shopsavvy config clear         # Remove saved key

The SHOPSAVVY_API_KEY environment variable takes precedence over the saved config.

Shortcuts

Command	Short
search	s
price	p
history	h
deals	d
usage	u

shopsavvy s "AirPods Pro"
shopsavvy p B0D1XD1ZV3

License

MIT