← TRAVIN.COM Setup guide · 15 to 20 minutes

Holiday Price Checker Setup

Connect your AI assistant to live price data so it can tell you, for every gift on your list, whether the price is a real deal, whether to buy now or wait for Black Friday, and whether to buy it on Amazon or pick it up at a store.

No coding for the basic setup Free to start
Your gift listRough is fine
Claude or ChatGPTYour assistant
Live pricesShopSavvy + Keepa
A verdictBuy, wait, or where
Before you start

What you are setting up

Two price-data services plug into your AI assistant as "connectors" (the technical name is MCP server). Once connected, you can just ask questions like "is $89 a good price for this?" and the assistant looks up the real numbers.

ShopSavvy

Prices at every store

Current prices for one product across tens of thousands of retailers (Amazon, Walmart, Target, Best Buy and many more), plus price history going back years. Works with a barcode number, a product link, a model number or just the product name.

Keepa (optional)

Deep Amazon history

The most detailed Amazon price history available: Amazon's own price vs. other sellers vs. used, plus long-term charts. Worth adding if most of your gifts come from Amazon. Needs a paid Keepa subscription and the Claude Desktop app.

What it costs

Start here ShopSavvy, no account $0 / month

Up to 10 lookups per minute and 100 per hour. Plenty for a holiday gift list.

Keepa subscription ≈ €19 (≈ $21) / month

Includes basic data access: roughly one Amazon lookup every few minutes. Check the current price on keepa.com.

Keepa data plan €49 / month

Much faster Amazon lookups. Only needed if the basic access feels slow.

ShopSavvy Starter $49 / month

14-day free trial. Higher limits for heavy use. Most people will not need this.

Recommendation: start with free ShopSavvy (Step 1). Add Keepa (Step 2) only if most of your list is Amazon and you use the Claude Desktop app. If you pay for anything, set a calendar reminder to cancel in early January.

0 Step 0

Pick your path

Tap the AI tool you use and follow only the steps listed for it.

Why no Keepa on the web or in ChatGPT? Web-based assistants can only reach connectors hosted on the internet. Keepa's connector runs as a small program on your own computer, which only the desktop app and the developer tools can start.

1A Claude · web, desktop or phone

Add ShopSavvy to Claude

You only do this once, on the web or in the desktop app. It then shows up on your phone too.

  1. Open claude.ai (or the Claude Desktop app) and go to Settings → Connectors. On some accounts this is under Customize → Connectors.
  2. Click Add custom connector (it may be behind a + button).
  3. For Name, type ShopSavvy.
  4. For Remote MCP server URL, paste this address:
    https://api.shopsavvy.com/mcp
  5. Leave everything else blank and click Add. No account or password is needed.
  6. Start a new chat, click the + button under the message box, open Connectors and make sure ShopSavvy is switched on.

Plan notes. The free Claude plan allows one custom connector. On a Team or Enterprise (work) account, only an organization owner can add it; ask them to add the URL above under Organization settings → Connectors, then you click Connect.

1B ChatGPT

Add ShopSavvy to ChatGPT

ChatGPT calls this "Developer mode". It needs a paid plan (Plus, Pro, Business, Enterprise or Edu) and is set up on the ChatGPT website. Menu names shift a little between updates; look for the closest match.

  1. On chatgpt.com, click your name, then Settings → Apps & Connectors (sometimes just Apps).
  2. Open Advanced settings and turn on Developer mode. Accept the warning about unverified apps.
  3. Back in Apps & Connectors, click Create.
  4. Fill in: Name ShopSavvy, Description Product prices and price history across retailers, and Server URL:
    https://api.shopsavvy.com/mcp
  5. For Authentication, choose No authentication. Tick I trust this application and click Create.
  6. In a new chat, click +, choose More (or Developer mode) and select ShopSavvy.
2 Optional · Claude Desktop only

Add Keepa for detailed Amazon prices

This step involves pasting a few lines into a settings file. Take it slowly and it works fine. Keepa's connector is a free community-built tool (not made by Keepa itself) that uses your Keepa account.

2a · Get your Keepa key
  1. Create an account at keepa.com and buy a subscription.
  2. Open the API page at keepa.com/#!api and copy your access key (a long string of letters and numbers).
  3. Treat this key like a password. Do not paste it into a chat with any AI assistant.
2b · Install Node.js (one time)
  1. Go to nodejs.org, download the version marked LTS and install it with the default options.
  2. Restart your computer afterwards so the desktop app can find it.
2c · Tell Claude Desktop about Keepa
  1. In Claude Desktop, open Settings → Developer and click Edit Config. A file called claude_desktop_config.json opens in a text editor.
    If the button is missing, the file lives here. Mac: ~/Library/Application Support/Claude/claude_desktop_config.json. Windows: %APPDATA%\Claude\claude_desktop_config.json.
  2. If the file is empty or only contains {}, replace everything with this, then swap PASTE_YOUR_KEEPA_KEY_HERE for your key (keep the quote marks):
    {
      "mcpServers": {
        "keepa": {
          "command": "npx",
          "args": ["-y", "keepa-mcp"],
          "env": {
            "KEEPA_API_KEY": "PASTE_YOUR_KEEPA_KEY_HERE"
          }
        }
      }
    }
  3. If the file already has an "mcpServers" section, add only the Keepa block inside it, with a comma after the block before it:
        "keepa": {
          "command": "npx",
          "args": ["-y", "keepa-mcp"],
          "env": {
            "KEEPA_API_KEY": "PASTE_YOUR_KEEPA_KEY_HERE"
          }
        }
  4. Save the file. Then fully quit Claude Desktop (Mac: ⌘ Q; Windows: right-click the tray icon and choose Quit) and open it again. Closing the window is not enough.
  5. In a new chat, click + and check that keepa appears in your list of connectors.

Speed. With the basic Keepa subscription, each Amazon lookup uses a few "tokens" and you earn about one token a minute, saved up for an hour. In practice: a handful of Amazon checks, then a short wait. If that gets in your way, Keepa's €49 data plan is about 20 times faster.

3 Step 3

Test that it works

Start a new chat with the connectors switched on and try these. The assistant should show that it is using ShopSavvy (or Keepa) and come back with real prices.

  1. Use ShopSavvy to look up the current prices for a LEGO Botanicals Bonsai Tree set at all retailers, lowest first.
  2. Use ShopSavvy to show the price history for that same product over the last 90 days. What was the lowest price, and where?
  3. If Keepa is connected: use Keepa to show the Amazon price history for that product over the last year, and compare Amazon's own price to other sellers.
4 Step 4

Use it for holiday shopping

Paste the prompt below into a new chat, fill in the blanks, and add your gift list. Rough descriptions are fine, such as "art kit for a 10-year-old under $40". The assistant will suggest specific products for vague items before pricing them.

Thu · Nov26Thanksgiving
Fri · Nov27Black Friday
Mon · Nov30Cyber Monday

What the verdicts mean

BUY NOWWithin 5% of its 90-day low.
WAITPrice crept up lately; recheck on Black Friday.
STOREAt least 10% or $10 cheaper than Amazon.
I'm doing my holiday shopping. For each item on my list below:

1. Use ShopSavvy to find current prices at all retailers and the price history for the last 90 days.
2. If Keepa is connected, also check the Amazon price history for the last year.
3. Put everything in one table with these columns: Item, Best price and store, Amazon price, 90-day low, Verdict, Route.

Use these rules:
- BUY NOW if the price is within 5% of its 90-day low.
- WAIT FOR BLACK FRIDAY if the price has gone up in the last few weeks (stores often raise prices before a sale so the discount looks bigger).
- Route to a STORE only if it is at least 10% or $10 cheaper than Amazon. Otherwise route to AMAZON.
- Only plan a store trip if the items at that store save $25 or more in total. If not, move them to Amazon.

Then give me three lists: (a) my store trips, grouped by store, (b) my Amazon cart, (c) items to recheck on Black Friday.

My ZIP code: ______
Stores I'm willing to visit: ______
Budget per person (optional): ______
Gifts that must arrive by a certain date: ______

My list:
-
-
- 

Change the rules to fit you

The 5%, 10%, $10 and $25 numbers are starting points. Tighter numbers mean fewer "buy now" calls and fewer store trips. Edit them in the prompt before you send it.

Recheck on sale days

On Black Friday and Cyber Monday, go back to the same chat and ask: "Recheck everything on my wait list and update the table."

About in-store prices. ShopSavvy shows the price each retailer lists online. Big chains usually charge the same in the store, but not always, and clearance prices are often set store by store. Before driving out, confirm the price and stock for your store in the retailer's own app. For Home Depot and Lowe's clearance, BrickSeek can show prices at nearby stores.

Power users

Claude Code, Codex, Cursor and similar

Run these in a terminal. Replace the placeholder keys with your own.

Claude Code

ShopSavvy, free (no key):

claude mcp add --transport http shopsavvy https://api.shopsavvy.com/mcp

ShopSavvy with a paid Data API key (higher limits):

claude mcp add --transport http shopsavvy https://api.shopsavvy.com/mcp \
  --header "Authorization: Bearer ss_live_your_key_here"

Keepa:

claude mcp add keepa -e KEEPA_API_KEY=your_key -- npx -y keepa-mcp
Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.keepa]
command = "npx"
args = ["-y", "keepa-mcp"]

[mcp_servers.keepa.env]
KEEPA_API_KEY = "YOUR_KEEPA_KEY"
Cursor and other JSON-config apps

Most tools accept the same mcpServers format as Claude Desktop. This runs both services on your computer (the ShopSavvy local version needs a paid key; without one, use the hosted URL above if your tool supports remote servers):

{
  "mcpServers": {
    "shopsavvy": {
      "command": "npx",
      "args": ["-y", "@shopsavvy/mcp-server"],
      "env": { "SHOPSAVVY_API_KEY": "ss_live_your_key_here" }
    },
    "keepa": {
      "command": "npx",
      "args": ["-y", "keepa-mcp"],
      "env": { "KEEPA_API_KEY": "YOUR_KEEPA_KEY" }
    }
  }
}

Use either the hosted ShopSavvy connector or the local one, not both, or your assistant will see every tool twice.

If something goes wrong

Troubleshooting

The connector does not appear in Claude Desktop

Fully quit the app and reopen it. Then check the config file for a missing comma or quote mark; pasting the file into a free online "JSON validator" will point to the exact line.

Error mentioning npx or "command not found"

Node.js is missing or the app cannot see it yet. Install the LTS version from nodejs.org and restart your computer.

The assistant answers from memory instead of looking prices up

Make sure the connector is switched on for that chat (the + menu), and start your request with "Use ShopSavvy to...".

ShopSavvy says you are rate limited

The free version allows 10 lookups a minute and 100 an hour. Wait a minute, or price your list in two batches.

Keepa says it is out of tokens

Tokens refill every minute. Wait a few minutes and ask again.

"Developer mode" is missing in ChatGPT

It requires a paid plan and the ChatGPT website. On a work account, your admin may need to enable it.

"Add custom connector" is greyed out in Claude

On a work account, an organization owner has to add it. On the free plan, you may already be using your one custom connector.

Keep your keys safe. API keys belong only in the settings file or setup screen, never in a chat message or a shared document. If a key leaks, generate a new one on the provider's site.