Skip to main content
Glama

shopping-research

A local MCP server that gives Claude Code live product search, cross-retailer prices, Amazon price history, community deals, and an optional Capital One Shopping cross-check, over free sources only. Every tool reports its own coverage: the response envelope is {data, sources_checked, sources_skipped}, so the calling skill can never claim a best price over a source it never saw.

Install as a plugin

Requires uv on your PATH; the server runs under uv run and creates its own environment on first start.

/plugin install shopping-research --marketplace tannerorourke/shopping-research-mcp

Claude Code prompts for the API keys when the plugin is enabled (SerpApi, eBay client ID and secret, Best Buy); each is optional and a blank one leaves that source registered and reported as disabled_in_settings. Edit them later under /plugin, Installed, Configure options. The SerpApi monthly budget and the Target toggle are options there too. Anything else from settings.toml.example (the C1 cross-check, cache TTL) goes in settings.toml inside the plugin's data directory, ~/.claude/plugins/data/<plugin id>/, where the server also keeps its SerpApi counter and eBay token. uv run playwright install chromium inside the installed plugin directory enables the headless-browser fallback.

The skill arrives as /shopping-research:shopping-research.

Related MCP server: Amazon MCP App

Run from a clone

  1. uv sync installs the environment (Python 3.12 or newer).

  2. cp settings.toml.example settings.toml and fill the keys you have. Each key can also come from the environment variable named in the file. A blank key leaves that source registered and reported as disabled_in_settings.

  3. uv run playwright install chromium enables the headless-browser fallback in extract_product and the optional c1_check.

  4. Register the server. Project scope: the shipped .mcp.json runs uv run server.py from this directory. User scope, so the tools are available from any directory:

claude mcp add --scope user shopping-research -- uv run --directory /absolute/path/to/shopping-research server.py
  1. Copy or symlink skills/shopping-research/ into ~/.claude/skills/ to make the skill available outside this repository.

Pass condition: get_status from a Claude Code session returns serpapi_remaining and the configured flags.

Sources

Source

Provides

Free tier

Key

SerpApi google_shopping / google_product

cross-retailer search and per-merchant offers

250 searches a month

SERPAPI_KEY

eBay Browse API

marketplace listings

5,000 calls a day

EBAY_CLIENT_ID, EBAY_CLIENT_SECRET

Best Buy Developer API

products, prices, availability

free key

BESTBUY_API_KEY

Target RedSky

price, availability

undocumented public key

none

Shopify /products/<handle>.json, schema.org JSON-LD, OpenGraph, Playwright

any product page

none

none

CamelCamelCamel

Amazon price history

polite scrape, one request

none

Slickdeals RSS

community deals (US)

hourly feed

none

Capital One Shopping extension via Playwright

coupon-adjusted cross-check on finalists

free account, off by default

sign in once in the profile

The SerpApi monthly counter and cache persist in ~/.best-price/ (override with BEST_PRICE_STATE). The server refuses SerpApi calls past monthly_budget.

Tools

search_products, compare_prices, extract_product, get_price_history, get_deals, c1_check, get_status, reload_settings. Signatures and the skip-reason vocabulary are documented in skills/shopping-research/SKILL.md; the vocabulary itself is sources/envelope.py.

Enabling the C1 cross-check

  1. Unpack the Capital One Shopping extension into extensions/c1shopping-unpacked/ (an unpacked directory, never a .crx).

  2. Set [c1] enabled = true and headless = false in settings.toml, run reload_settings, call c1_check on an Amazon product URL, and sign in when the extension asks.

  3. In chrome://extensions, open the extension's service worker and read the price-comparison endpoint from its Network tab. Write a unique substring of it into api_url_filter.

  4. Set headless = true and reload_settings. c1/parsers.py is written against the common payload shapes; adjust it once if the endpoint's shape differs.

Tests

uv run pytest -q. The suite uses httpx.MockTransport and launches no browser.

Sources and their terms

SerpApi, eBay, Best Buy, and Slickdeals RSS are used through their published interfaces. Target's search endpoint is undocumented and CamelCamelCamel is read as a web page, one request per call and never retried; both sites may refuse automated requests, and the server reports that as blocked rather than working around it. The Capital One Shopping cross-check drives a browser extension in your own signed-in profile and is off by default. Use each source within its terms.

Available Tools

8 tools
c1_checkC1 CheckB

Optional Capital One Shopping cross-check on one finalist URL. Off unless [c1] enabled = true; returns sources_skipped disabled_in_settings otherwise. data: {c1_best, offers}.

Inputs: url (required). Returns: object

compare_pricesCompare PricesA

Per-merchant offers for one product. Pass the SerpApi product_id from search_products, or a query (the retailer APIs are searched by it too). data: [{merchant, price, url}] ascending.

Inputs: query, product_id. Returns: object

extract_productExtract ProductB

Title, price, currency, availability from any product page: Shopify JSON, schema.org JSON-LD, OpenGraph, then a headless-browser fallback.

Inputs: url (required). Returns: object

get_dealsGet DealsC

Community-vetted deals from Slickdeals RSS (US). data: [{title, price, store, url, votes}].

Inputs: query, category. Returns: object

get_price_historyGet Price HistoryB

Amazon price history from CamelCamelCamel. Accepts an ASIN or an amazon.com product URL. data: {lowest, highest, average, current, verdict} or None with skip reason not_amazon.

Inputs: asin. Returns: object

get_statusGet StatusA

Coverage before spending quota: which sources are configured, SerpApi searches left this month, whether the C1 cross-check is enabled.

Inputs: no named parameters. Returns: object

reload_settingsReload SettingsA

Re-read settings.toml without restarting. A running C1 browser is closed if enabled flips to false.

Inputs: no named parameters. Returns: object

search_productsSearch ProductsB

Find candidate products across Google Shopping (SerpApi), eBay, Best Buy, and Target. data: [{title, price, merchant, url, product_id}] sorted by price ascending.

Inputs: query (required), num. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation4/5

    Each tool has a fairly distinct role: search_products finds candidates, compare_prices drills into per-merchant offers for one item, extract_product scrapes a single page, get_deals pulls a separate community feed, and c1_check is an optional cross-check. The boundaries between search_products and get_deals overlap somewhat (both surface deals/products), but descriptions make the distinction clear enough.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (search_products, compare_prices, extract_product, get_price_history, get_deals, get_status, reload_settings). The only deviation is c1_check, which uses a vendor prefix instead of a verb and breaks the pattern.

    Tool Count5/5

    Eight tools is well-scoped for a shopping research workflow, with each tool earning its place across search, comparison, extraction, history, deals, cross-check, status, and config. No redundancy or filler.

    Completeness4/5

    The surface covers the core research lifecycle: discovery, price comparison, page extraction, price history, deals, quota/status, and config reload. Minor gaps exist (no result saving/watchlist or persistent alerting, and price history is Amazon-only), but agents can work around these.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI models to find the best online deals by browsing and interacting with multiple shopping platforms like Amazon and eBay across various regions. It uses Playwright to automate searches and retrieve product information from compatible e-commerce and deal-tracking websites.
      13 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Lets Claude search Amazon products via multiple keyword queries and present curated results in an interactive carousel widget with add-to-cart functionality.
      1
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables Claude to search and analyze product listings from multiple French marketplaces, evaluating price, delivery, and distance to a reference point to find the best value.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables product comparison and analysis for any MCP-compatible AI assistant, with tools like compare_products and list_products.
      -