ShopSavvy for Jupyter

Magic commands for product search and price comparison in Jupyter notebooks. Search products, compare prices, and view price history — all inline in your notebook.

Install

pip install jupyter-shopsavvy

Quick Start

# Load the extension
%load_ext jupyter_shopsavvy

# Search for products
%shopsavvy_search AirPods Pro

# Compare prices across retailers
%shopsavvy_price B0D1XD1ZV3

# View price history
%shopsavvy_history B0D1XD1ZV3 --days 90

# Check API usage
%shopsavvy_usage

Commands

Command	Description
%shopsavvy_search <query>	Search products by keyword
%shopsavvy_price <identifier>	Compare prices across retailers
%shopsavvy_history <identifier>	View price history
%shopsavvy_usage	Check API usage

Options

# Limit search results
%shopsavvy_search iPhone 16 --limit 3

# Get raw JSON (useful for further processing)
%shopsavvy_search AirPods --json

# Custom history range
%shopsavvy_history B0D1XD1ZV3 --days 365

JSON Output

Add --json to any command to get raw JSON, then use it in your analysis:

import json

# Capture JSON output
result = %shopsavvy_search iPhone 16 --json --limit 5

Configuration

Set your API key as an environment variable:

import os
os.environ["SHOPSAVVY_API_KEY"] = "ss_live_your_key_here"

Get your API key at shopsavvy.com/data.

License

MIT