ShoppingScraper User Guide

How to use

1. Check your credit balance and account health at the top
2. Use Quick Product Lookup to search by EAN/GTIN across Google Shopping
3. Click any feature card under "What would you like to do?" to get started
4. Monitor active schedulers and today's run count in the stats bar

How to use

1. Click + New Scheduler to create a new price monitor
2. Choose a scheduler type: Marketplace (Google Shopping, Bol.com, Amazon, Coolblue), Webshop (specific store domain), or URLs (direct product page URLs)
3. Select a target site — Google Shopping covers 40+ countries (Netherlands, Germany, France, UK, US, and more), plus Bol.com, Amazon (NL/DE/FR/BE), and Coolblue (NL/BE/DE)
4. Set your schedule frequency: Daily (08:00), 2x Daily (08:00 & 12:00 or 08:00 & 17:00), 4x Daily, Workdays (Mon–Fri), Weekly, Monthly, or Run Once
5. Add your products using one of 3 EAN input methods (see below)
6. Monitor match rates and status from the overview

3 Ways to Add Products

1. Manual Entry — Paste up to 100,000 EAN/ASIN codes directly into the text area (one per line). Best for one-time setups or quick tests.
2. Import from Feed URL — Provide a URL to a CSV file (e.g., Channable export). ShoppingScraper previews the file and lets you map the EAN column. This is a one-time import.
3. Use Product Feed — Connect a live product feed (set up in Product Feeds). The scheduler permanently syncs with the feed and automatically picks up new products or removes discontinued ones on each run.

Available tabs

1. Info — Scheduler settings, run history, and overview statistics
2. Pricing Dashboard — Price trend charts and analytics
3. Merchants — Compare prices across all merchants found
4. EAN Detail — Per-product deep-dive with full price history

Key sections

1. Stats overview — Total unique EANs, matched products, match rate %, total data points, unique merchants, and days of data collected
2. Most Competitive Products — Products with the most merchants selling them, showing the cheapest price for each
3. Filters — Search by EAN or product name, toggle Market vs Webshop view, filter by Merchant or Brand, and sort by price, name, or merchant count

What you see

1. Top 5 Sellers by Product Coverage — Merchants with the largest share of your tracked products, ranked by product count and coverage percentage. Shows which competitors have the broadest assortment.
2. Price Leaders — Merchants who are the cheapest most often across all tracked products. Shows how many times each merchant had the lowest price.

How to use

1. Click any product EAN in the Pricing Dashboard to open its detail page
2. Review the product card: image, name, manufacturer, EAN, SKU
3. Check the summary cards: cheapest price, price change, average price
4. Study the Price Position Matrix to see all merchants positioned by price
5. Toggle between Market and Webshop views to compare against your own store

Chart tabs

1. Lowest Price (ShoppingScraper) — Shows the cheapest price trend over time from your own scheduler data. Toggle between Total, Base, and Shipping prices.
2. All Sellers (ShoppingScraper) — Plots every merchant's price on a single graph. Use merchant filter chips to isolate specific competitors. Toggle Total/Base/Shipping.
3. Last 6 Months (External Data) — Long-term price history from external third-party data sources (not ShoppingScraper data). Shows Average Price, Lowest Price, and your Current Price as a reference line.

What you see

1. Average Price (blue line) — The market average across all known sellers over 6 months
2. Lowest Price (green line) — The cheapest available price at each point in time
3. Current Price (dashed orange line) — Your product's current price as a reference baseline

How to use

1. Scroll down to All Price Points on the EAN detail page
2. Filter by date range, sort by price or date, filter by condition (New/Refurbished)
3. Toggle "Latest Only" to see just the most recent prices
4. Use "Hide excluded merchants" to filter out irrelevant sellers
5. Click any merchant name to open the Merchant Detail modal
6. Click "View" to visit the product directly on the merchant's website

3-Step Alert Wizard

1. Step 1 — Choose Alert Type:
   • Price Drop — Any price drops below your threshold
   • Competitor Price Drop — A specific competitor drops below a threshold
   • MAP Violation — A competitor sells below Minimum Advertised Price (requires product feed with MAP prices)
   • I'm Not Cheapest — Any competitor is cheaper than you
   • Competitor Beats My Price — Any competitor drops below your price
   • Specific Competitor Beats Me — A named competitor is cheaper than you
2. Step 2 — Configure: Choose scope (single product, brand, or all products), select the target EAN, set the threshold price, and pick the target merchant (for competitor-specific alerts)
3. Step 3 — Notifications: Set an alert name, enable email notifications, configure cooldown hours (to avoid alert fatigue)

Practical examples

1. "Alert when LEGO 42151 drops below €120" — Use Price Drop, select the product, set threshold to 120
2. "Alert when Amazon.nl undercuts me on any product" — Use Specific Competitor Beats Me, select Amazon.nl as the target merchant
3. "Alert when I'm not the cheapest for any tracked product" — Use I'm Not Cheapest with "All Products" scope

How to use

1. Open any scheduler and click the Merchants tab
2. Review the summary stats: total merchants and tracked products
3. Check Top 5 rankings for price leadership and coverage
4. Filter the merchant table by brand using the dropdown
5. Click any merchant row to see detailed company information
6. Export the full merchant list as CSV for further analysis

How to use

1. Click on any merchant name in the price table or merchants overview
2. Review company info: name, domain, address, country
3. Check founding year and employee count for company size
4. Read the AI-generated company description
5. Check the TrustPilot review score and summary

How to use

1. Open any scheduler and click the API tab
2. Copy your API Key and Scheduler UUID
3. Use the provided curl commands: GET scheduler, POST run, GET reports, GET latest report
4. Download reports in CSV or XLSX format
5. Fetch real-time offers for single EANs across Google Shopping, Amazon, Bol.com

How to use

1. Paste your product feed URL (Google Shopping XML, CSV, or custom format)
2. ShoppingScraper automatically extracts EAN/GTIN codes from your feed
3. Link the feed to a scheduler for automatic product syncing
4. Products are refreshed on each scheduler run

How to use

1. Enter an EAN/GTIN code for the product to compare
2. Select the countries you want to compare (up to 10)
3. View a side-by-side comparison of prices per country and merchant

How it works

1. Select a scheduler — Pick a price scheduler to use as data source
2. Connect a product feed with purchase prices so the system can calculate margins
3. Define pricing rules using the rule wizard (see categories below)
4. Review recommendations — The dashboard shows price changes (up/down/unchanged), market position, average gap, and competitive score
5. Approve or auto-apply — Use Simulation Mode to test safely, then enable auto-repricing
6. Export via Feed URL — The system generates a feed URL with repriced data for your webshop to consume

Available categories

1. Competitor Rules (8 types) — Beat lowest by %, Beat lowest by EUR, Match lowest price, Match market average, Match specific merchant, Stay within % of market, Premium positioning, Competitor out-of-stock increase
2. Safety Rules (5 types) — Minimum price floor, Maximum price ceiling, Minimum margin %, MAP compliance, Maximum daily price change %
3. Stock / Velocity Rules (4 types) — Low stock raise price, High stock lower price, Out of stock deactivate, Overstock clearance
4. Time-Based Rules (3 types) — Weekend pricing, Peak hours premium, Seasonal adjustment

Every rule type supports optional Product Scope filters — restrict the rule to specific brands and/or product type tags from your feed. Set these in Step 3 of the wizard.

Configuration options

1. Feed Refresh Frequency — How often your product feed is refreshed (every hour to daily)
2. Reprice after scraper run — Automatically recalculate prices when new competitor data comes in
3. Reprice after feed refresh — Recalculate when your product feed updates (e.g., stock changes)
4. Simulation Mode — Calculate recommendations without actually applying them — perfect for testing new rules
5. Rule Resolution Strategy — Choose how the engine resolves multiple matching rules: Sequential (first match wins), Minimum price, Maximum price, or Closest to original price
6. Margin Protection — A global safety net that automatically prevents the engine from recommending prices below your minimum margin percentage. When enabled, even without a dedicated min_margin_pct safety rule, the engine will raise prices to maintain your target margin. Requires purchase prices in your product feed.
7. Never price above RRP — Automatically caps any recommended price at the product's RRP (verkoopadviesprijs/recommended retail price) from your feed. Enabled by default. Prevents overpricing above manufacturer guidelines.
8. Per-rule Rounding — Competitor rules can optionally override the global charm pricing setting. When editing a competitor rule, set a specific rounding strategy (e.g., .99, .95, nearest .50) that applies only to products matching that rule. If not set, the global rounding setting is used.
9. Email Alerts — Get notified when repricing detects critical issues like products below breakeven or large price swings
10. Feed URL — A generated URL your webshop can consume to import repriced product data

Key capabilities

1. Price Index — A real-time metric showing your price position relative to the market average (100 = market average). Values below 100 mean you're cheaper, above 100 means you're more expensive. Displayed as a column in the product table and aggregated in the Market Position card.
2. Competitor Stock Rules — Use the "Competitor out-of-stock increase" rule to automatically raise your price when competitors are out of stock. The engine checks competitor availability from your scraped data and lets you capitalize on reduced competition.
3. Multi-Rule Resolution — When multiple competitor rules match a product, choose how the engine picks the final price: Sequential (highest priority wins, the default), Minimum (cheapest price across all matching rules), Maximum (highest price), or Closest to Original (smallest change from current price). Configure this in Settings.
4. Price History Charts — Each product detail view includes a 30-day price trend chart showing market average, lowest competitor price, and your current price as a reference line. Quickly spot pricing trends without leaving the dynamic pricing dashboard.
5. Saved Filter Views — Save frequently used filter combinations (search term, rule type, brand, velocity, direction, price index range) as named views. Click a saved view chip to instantly restore its filters. Useful for monitoring specific product segments like "Premium brands only" or "Products priced below market".
6. Product Scope (Brand & Tag Filters) — Narrow any pricing rule to specific products by brand and/or product type tags. In the rule wizard (Step 3), use the searchable Brand and Tag dropdowns — type to filter, click to select, and selected items appear as removable chips. A live counter shows how many products will be affected (e.g., "This rule applies to 342 of 1,921 products"). When both are set, a product must match at least one selected brand and at least one selected tag. Rules with scope filters show blue (brand) and yellow (tag) badges on the rules list.
7. Sortable Recommendation Table — Click any column header (Product, Current Price, Recommended Price, Change %, Lowest Competitor, Margin, Index) to sort the recommendations table. Click again to toggle between ascending and descending order. A sort indicator arrow shows the current sort direction.
8. Duplicate Rules — Quickly clone any pricing rule by clicking the "Duplicate" button on the rule card. This creates a copy with the same settings (type, value, conditions, constraints) but with "(copy)" appended to the name. Perfect for creating similar rules for different brand scopes.
9. Time-Based Rules — Adjust prices automatically based on time: Weekend pricing (select active days, e.g., raise prices 3% on Sat/Sun), Peak hours premium (set start/end hours for price adjustments), and Seasonal adjustment (pick active months for seasonal discounts or increases).
10. Data Freshness Indicator — The dashboard shows when prices were last scraped (e.g., "2 hours ago") so you always know how current your competitor data is.

How it works

1. Create a promotion — Click "New Promotion" to open the 3-step wizard
2. Define details — Set a name, description, start/end dates, and select which schedulers to use as data sources
3. Select retailers — Pick which retailers to monitor from the aggregated list across all your schedulers
4. Add products & promo prices — Select products, set promotional prices and RRP/MAP per product
5. Track compliance — View inline or full-page reports showing which retailers have activated your promo, sell at a different price, or haven't listed the product

Status colors

1. Green (Activated) — Retailer is selling at your promo price
2. Yellow (Different Price) — Retailer has the product but at a different price
3. Amber (Out of Stock) — Product is listed but out of stock
4. Red (Not Listed) — Product is not listed at this retailer
5. Blue (Listed) — Product is listed (no promo price set to compare against)

How to use

1. Enter an EAN/GTIN, ASIN, or product URL — product info is fetched automatically. Or click Upload to use your own product photos.
2. Choose a generation mode:
   • Single Product — Generate images for one product at a time
   • Batch Mode — Paste multiple EANs to generate images for all products at once
   • Multiple Products — Combine 2–4 products into a single scene image
3. Select a Prompt Approach: "Review First" lets you preview and edit AI-generated prompts before creating images; "Direct Generate" creates images immediately
4. Pick one or more image types (10 styles available — see below) and set how many images per type (1–10)
5. Optionally write a Custom Prompt or load one from the Prompt Library
6. Click Generate Image — results appear in the inline gallery below

10 Image Types

1. Amazon White BG — Pure white background, marketplace compliant (no text overlay)
2. Studio Photo — Professional studio photography, clean background (no text)
3. Lifestyle — Product in real-world use, natural environments
4. Flat Lay — Overhead/bird’s-eye view composition
5. Size Scale — Shows actual product size with reference objects
6. Multi-Angle — Multiple perspectives in one image
7. Infographic — Marketing image with text overlays and feature callouts
8. Product Ad — Advertising-style promotional images
9. Comparison — Before/after or side-by-side comparison
10. Illustrated — Cartoon/illustration style rendering

Style Extraction

Extract a reusable visual design system from any website to ensure consistent branding across all generated images.

1. Expand Brand, Style & Settings in the generation form
2. Paste a website URL (e.g. https://coolblue.nl) and click Extract Style (costs 25 credits, or 50 credits with preview)
3. Review the extracted style — colors, typography, mood, and background treatment are shown in a preview
4. The style is saved automatically and appears in the "My Saved Styles" dropdown for reuse
5. Select a saved style from the dropdown before generating — it takes highest priority for style matching

Inline Gallery & Actions

Generated images appear in "Your Generated Images" below the generator. Each card shows:

1. Source images — Thumbnail previews of the original product photos used (max 4 shown; click "+N" to see all in an overlay)
2. Composition — The AI-generated scene description explaining the visual approach
3. Download — Save the image in original resolution
4. Refine — Send feedback to regenerate a variation (e.g. "Make the background darker" or "Remove the text overlay")
5. Delete — Remove the image from your gallery

What each card shows

1. Product info — Name, EAN, image style badge, and generation date
2. Source images — Thumbnails of the original product photos used as reference. Cards show up to 4; click the "+N" button to view all source images in a full overlay.
3. Composition — The AI-generated prompt/scene description (click "show more" to read the full text)
4. Actions — Download the image, Refine it with feedback, or Delete it

How to use

1. Open the References tab in AI Images
2. Click Upload Images or drag & drop files into the drop zone (JPG, PNG, WebP, GIF — up to 5 at a time)
3. Uploaded images appear in a grid as your Reference Image Library
4. Switch to the Generator tab and expand Brand, Style & Settings
5. Your reference images appear under Style Reference Images — click to select up to 14 as visual guides for the next generation

How to use

1. Enter an EAN/GTIN, ASIN, or product URL — or switch to Batch Mode and paste multiple EANs
2. Select the Content Language (15 languages: English, Dutch, German, French, Italian, Spanish, Portuguese, Polish, Swedish, Danish, Norwegian, Finnish, Czech, Romanian, Hungarian)
3. Expand Content Settings to customize tone, title length, USP count, description paragraphs, specs count, and more
4. Click Fetch & Generate to create content
5. View the full product page (PDP preview) with all generated fields
6. Download individual items as JSON, or download batches as CSV or XLSX

Generated Content Fields

1. Product Title — Optimized product title with configurable max length
2. Short SEO Title — Compact SEO-friendly title for search results
3. USPs — Unique selling points with configurable count and max length
4. Description — Full product description with configurable paragraph count and length
5. Short Description — Concise summary for product cards/listings
6. Expert Review — AI-written product review from an expert perspective
7. Specifications — Structured key-value specs
8. Pros & Cons — Balanced product evaluation
9. Meta Description — SEO meta tag text
10. SEO Keywords — Relevant search keywords
11. Product Category — Category hierarchy (e.g. Electronics > Audio > Headphones)

Content Gallery

All generated content is stored for 30 days in "Your Generated Content" below the generator:

1. Search by product name or EAN
2. Filter by language and sort by date or name
3. Click any item to view the full PDP preview
4. Batch items are grouped with CSV and XLSX download buttons

How to use

1. Open AI Content Generator and click the Tone of Voice button in the settings area
2. Click Create New Profile to define a new tone profile
3. Fill in the profile fields:
   • Name — A descriptive name (e.g. "Coolblue Friendly" or "Tech Expert Formal")
   • Style Description — Describe the overall writing style
   • Target Audience — Who the content is written for
   • Formality — Casual, neutral, or formal tone
   • Narrative Style — First person, second person, or third person
   • CTA Strategy — How calls-to-action should be phrased
   • Keywords to Include — Words and phrases that should appear in the content
   • Words to Avoid — Words and phrases that should never be used
4. Optionally paste sample text and click Analyze Tone — AI will extract tone characteristics automatically
5. Save the profile and select it from the Tone of Voice dropdown before generating content

How to use

1. Enter an EAN code in the search field
2. Select a country (Netherlands, Belgium, Germany, France, etc.) to target the right Google Shopping region
3. Click Download — images are fetched from two sources:
   • Merchant Images (ImageHD) — High-resolution product photos from manufacturer databases
   • Google Shopping — Product images from Google Shopping listings in the selected country
4. Browse results with image previews — click any image to download individually
5. Your search history is saved in Recent Downloads below, with thumbnail previews for quick access to previous lookups

How to use

1. Enter a 13-digit EAN code (e.g., 5702017416663)
2. Click Lookup to retrieve full product information
3. View product details including name, brand, images, and category

Key Features

1. Price Chart — Interactive Chart.js visualization showing weekly average (blue) and weekly low (green dashed) price lines
2. Stats Cards — Current average, lowest price, highest price, period average, and price change percentage at a glance
3. Time Range — Toggle between 3-month, 6-month, and 12-month views
4. Weekly Data Table — Full breakdown by week with period dates, average/low prices, and week-over-week change
5. CSV Export — Download price history data as CSV for external analysis
6. Deep Links — Jump to API Playground to search offers or view Product Variants for the same EAN
7. Recent Searches — Quick-access chips for previously searched EANs

How It Works

1. Step 1: Search — Enter an EAN/GTIN and select a country. The tool searches Google Shopping to find the product and its catalog ID (SKU)
2. Step 2: Select — If multiple products match, pick the correct one from the results list
3. Step 3: View Variants — See all variant dimensions (Color, Size, etc.) displayed as visual cards with thumbnails, labels, and catalog IDs

Key Features

1. Variant Grid — Visual cards for each variant option showing thumbnail, label, title, and SKU code
2. Current Variant — The currently selected variant is highlighted with a blue border and "Current" badge
3. Search Offers — Click "Offers" on any variant to search for its prices in the API Playground
4. Price History — Click "History" to view the price trend for the product
5. Image Gallery — Browse all available product images from Google Shopping
6. Summary Stats — Total variant count, dimension count, and image count at a glance

Key Features

1. Company Information — Name, address, phone, email, industry, founding year, and CEO when available
2. Website Preview — Live screenshot of the merchant's website with favicon and direct link
3. Social Media Links — Direct links to Facebook, Instagram, Twitter/X, LinkedIn, YouTube, TikTok, and Pinterest profiles
4. Brands & Product Types — See which brands the merchant carries and what product categories they offer
5. Company Description — Full business description when available from public data sources
6. Recent Searches — Quick-access chips for previously searched domains

Available API Tabs

1. Offers (EAN) — Search for product offers by EAN/GTIN across Google Shopping, Bol.com, Amazon, Coolblue, or Global multi-source. Supports country selection and subscription filtering.
2. Webshop (EAN) — Look up a specific EAN on a specific webshop domain (e.g., ah.nl, fonq.nl, mediamarkt.nl)
3. Page Scraper — Extract structured product data from any product page URL
4. Search (Keyword) — Search Google Shopping by keyword with country and page number controls
5. Product Info — Get detailed product information for an EAN from Google Shopping or Amazon/Bol.com
6. Match / DeepSearch — Find the matching Google Shopping product for an EAN, returning the SKU ID. Enable DeepSearch (4 credits) for AI-powered matching with optional product title and URL metadata. Regular match costs 1 credit.

How to use

1. Enter a website URL (e.g., competitor-store.com)
2. The tool automatically finds and parses the sitemap.xml
3. Filter and export product page URLs
4. Use extracted URLs directly in a URL-based scheduler

How to use

1. Copy the MCP configuration JSON from the setup page
2. Add it to your Claude Desktop config or Claude Code settings
3. Restart Claude — ShoppingScraper tools are now available
4. Ask Claude things like "Find the cheapest price for EAN 5702017416663"

Monitored services

1. Amazon — Amazon product data scraping service
2. Bol.com — Bol.com price and product data
3. ShoppingScraper API — Core API availability
4. Google Shopping — Google Shopping price data
5. Google Shopping Match — EAN-to-product matching service

Email Alerts

Switch to the Email Alerts tab to subscribe to downtime notifications. Receive an email when a service goes down or comes back up.