shopping-research
Provides Amazon product price history via CamelCamelCamel and supports optional Capital One Shopping cross-checks on Amazon product URLs.
Provides marketplace listings and prices through the eBay Browse API.
Provides cross-retailer product search and per-merchant offers via Google Shopping through SerpApi.
Extracts product details and prices from Shopify product pages using the /products/.json endpoint, schema.org JSON-LD, OpenGraph, and a headless-browser fallback.
Provides product price and availability through Target's RedSky endpoint.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@shopping-research find the best price on a Sony WH-1000XM5 across retailers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpClaude 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
uv syncinstalls the environment (Python 3.12 or newer).cp settings.toml.example settings.tomland 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 asdisabled_in_settings.uv run playwright install chromiumenables the headless-browser fallback inextract_productand the optionalc1_check.Register the server. Project scope: the shipped
.mcp.jsonrunsuv run server.pyfrom 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.pyCopy 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 | cross-retailer search and per-merchant offers | 250 searches a month |
|
eBay Browse API | marketplace listings | 5,000 calls a day |
|
Best Buy Developer API | products, prices, availability | free key |
|
Target RedSky | price, availability | undocumented public key | none |
Shopify | 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
Unpack the Capital One Shopping extension into
extensions/c1shopping-unpacked/(an unpacked directory, never a.crx).Set
[c1] enabled = trueandheadless = falseinsettings.toml, runreload_settings, callc1_checkon an Amazon product URL, and sign in when the extension asks.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 intoapi_url_filter.Set
headless = trueandreload_settings.c1/parsers.pyis 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 toolsc1_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
Scored across 8 tools
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.
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.
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.
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
Product search for AI shopping agents: prices and buy links from big retailers. No key needed.
AI-powered product search, affiliate links, and price negotiation for e-commerce platforms
Product price checks and affiliate link building for AI shopping agents.
Cross-merchant product search with real price history, comparisons, and demand signals.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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 npm3MIT
- AlicenseNot gradedqualityDmaintenanceLets Claude search Amazon products via multiple keyword queries and present curated results in an interactive carousel widget with add-to-cart functionality.1MIT
- FlicenseNot gradedqualityBmaintenanceEnables 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.-
- FlicenseNot gradedqualityDmaintenanceEnables product comparison and analysis for any MCP-compatible AI assistant, with tools like compare_products and list_products.-