MCP Integration for AI Assistants
23 tools across 6 categories — product data, price schedulers, dynamic pricing, feed management, AI content, and AI images. Works with Claude Desktop, Claude Code, OpenAI Responses API, and any MCP-compatible client.
How to get started
Claude Desktop (Extension)
Download the personalized .dxt extension file from your dashboard. In Claude Desktop, go to Settings, then Extensions, then Install from file. Your API key is embedded in the extension — no manual configuration needed.
Claude Code (CLI)
Run the CLI command to add the MCP server: claude mcp add --transport http shoppingscraper https://app.shoppingscraper.com/mcp/v1/ --header "X-API-Key: YOUR_KEY". Replace YOUR_KEY with your ShoppingScraper API key.
OpenAI Responses API
Add ShoppingScraper as an MCP tool source in your API request: set type to "mcp", server_url to "https://app.shoppingscraper.com/mcp/v1/", and pass your API key in the headers object. Works with the OpenAI Agents SDK via MCPServerStreamableHttp.
Any MCP client
Connect any MCP-compatible client using Streamable HTTP transport (MCP 2025-03-26 spec) to https://app.shoppingscraper.com/mcp/v1/. Authenticate with X-API-Key or Authorization: Bearer header. The server also supports the 2024-11-05 fallback protocol.
Start querying
Ask your AI assistant to search products, compare prices, create schedulers, generate pricing rules, or create AI content. All 23 tools are available through natural language conversations.
What you get
- 23 tools across 6 categories accessible via natural language
- Product search across Google Shopping, bol.com, Amazon, Coolblue
- Product details, offers, and price comparisons by EAN
- Price scheduler creation and management with automated monitoring
- Dynamic pricing rules: margin target, competitor match, cost-plus, price position
- AI-powered price recommendations with competitor analysis
- Feed management: import, refresh, and search product feeds
- AI content generation: titles, descriptions, USPs, specs, pros/cons
- AI image generation: lifestyle, studio, flat lay, product ad styles
- Infographic generation with visual layout prompts
- Works with Claude Desktop, Claude Code, and OpenAI
- Streamable HTTP protocol (MCP 2025-03-26) with legacy fallback
- Secure API key authentication via header
- No coding required — use through conversation
6 tool categories, 23 tools
The MCP server exposes 23 tools organized in 6 categories. Product Data tools let you search marketplaces and retrieve product details and offers. Price Schedulers automate monitoring with configurable frequency and country targeting. Dynamic Pricing tools create and apply pricing rules with AI recommendations. Feed Management handles product catalog imports. AI Content Generation creates product descriptions on demand. AI Images generates product photos and infographics.
- Product Data (4 tools): search_products, get_product_info, get_product_offers, check_subscription
- Price Schedulers (5 tools): create, list, get details, trigger runs, retrieve results
- Dynamic Pricing (4 tools): pricing rules, AI recommendations, repricing calculations
- Feed Management (5 tools): import, refresh, search, and manage product feeds
- AI Content (2 tools): generate product copy and browse content gallery
- AI Images (3 tools): product photos, infographics, and image gallery
Connect ShoppingScraper to Claude AI via MCP
Multi-client support
The MCP server uses the Streamable HTTP transport from the MCP 2025-03-26 specification, with automatic fallback to the 2024-11-05 protocol for older clients. This means it works with Claude Desktop (via .dxt extension or manual config), Claude Code (via CLI), the OpenAI Responses API, the OpenAI Agents SDK, and any other MCP-compatible client. One server, every AI assistant.
- Claude Desktop: install the .dxt extension file for zero-config setup
- Claude Code: single CLI command to register the MCP server
- OpenAI Responses API: add as an MCP tool source in your API calls
- OpenAI Agents SDK: use MCPServerStreamableHttp from the openai-agents package
- Any MCP client: standard Streamable HTTP transport with API key auth
Example prompts by use case
Because the MCP server exposes structured tools, you interact with ShoppingScraper through natural language. Here are prompts that demonstrate the range of what you can do across all 6 categories.
- Product search: "Search for iPhone 16 Pro prices on Google Shopping NL"
- Price comparison: "Get all offers for EAN 5702017416663 and show the cheapest seller"
- Scheduler setup: "Create a daily price scheduler for EANs 8710398000019 and 5702017416663"
- Dynamic pricing: "Create a competitor_match pricing rule 2% below the cheapest competitor"
- AI content: "Generate a Dutch product description with USPs for EAN 8710398000019"
- AI images: "Generate a lifestyle product photo for my product"
Secure and private
Your API key is passed via the X-API-Key header or Authorization: Bearer header and is never stored on third-party servers. Claude Desktop stores it locally in your extension configuration. Claude Code stores it in your local MCP config. For OpenAI integrations, the key is included in your server-side API request and never exposed to the client.
- API key transmitted only in request headers to ShoppingScraper
- No data shared with third parties beyond your chosen AI provider
- Direct HTTPS communication with app.shoppingscraper.com
- Works with your existing ShoppingScraper plan and credits
Setup examples
Connect the ShoppingScraper MCP server to your preferred AI client. Replace YOUR_KEY with your API key from the dashboard.
claude mcp add --transport http shoppingscraper https://app.shoppingscraper.com/mcp/v1/ --header "X-API-Key: YOUR_KEY"Frequently Asked Questions
What is MCP?+
MCP (Model Context Protocol) is an open standard for connecting AI assistants to external tools and data sources. It allows Claude Desktop, Claude Code, OpenAI, and other compatible clients to interact with ShoppingScraper through natural language.
Which MCP protocol version is supported?+
The server implements the MCP 2025-03-26 specification using Streamable HTTP transport. It also supports automatic fallback to the 2024-11-05 protocol for older clients.
Do I need an API key?+
Yes. You need a ShoppingScraper API key, which is included in your account. The free tier includes 100 credits for testing. Pass the key via the X-API-Key header or Authorization: Bearer header.
How many tools are available?+
23 tools across 6 categories: Product Data (4), Price Schedulers (5), Dynamic Pricing (4), Feed Management (5), AI Content Generation (2), AI Images (3).
Does it work with OpenAI?+
Yes. The MCP server works with the OpenAI Responses API by adding it as an MCP tool source, and with the OpenAI Agents SDK using MCPServerStreamableHttp. Any MCP-compatible client can connect.
What is the .dxt extension file?+
The .dxt file is a personalized Claude Desktop Extension with your API key embedded. Download it from your dashboard and install it in Claude Desktop under Settings, Extensions, Install from file. No manual configuration required.
Is my API key secure?+
Yes. Your API key is stored locally in your client configuration (Claude Desktop extension, Claude Code config, or your server-side code for OpenAI). It is only transmitted in HTTPS request headers directly to ShoppingScraper.
Which queries can I run?+
Any query that maps to the 23 available tools: product searches, price lookups, offer comparisons, scheduler management, dynamic pricing rules, feed operations, AI content generation, and AI image creation.
Does it cost extra?+
No. The MCP integration is free. API requests made through any MCP client consume credits from your existing ShoppingScraper plan, the same as direct API calls.
Can I use it with Claude Code?+
Yes. Run the CLI command to register the MCP server: claude mcp add --transport http shoppingscraper https://app.shoppingscraper.com/mcp/v1/ --header "X-API-Key: YOUR_KEY". All 23 tools become available in your Claude Code sessions.