crawlo-mcp

An MCP (Model Context Protocol) server that connects Claude to Crawlo e-commerce product data. Search, compare, and analyze product listings, cross-retailer matches, and Google Shopping data across European markets — directly from Claude Desktop or any MCP-compatible client.

20 free queries per session. No API key required to start.

What Data Is Available?

Product Listings (getProductListings)

Per-retailer product data — pricing, offers, availability, content quality.

| Data | What You Get | |------|-------------| | Product identity | Name, brand, EAN, ASIN, MPN, URL, images | | Pricing & offers | All seller offers with price, currency, availability, shipping, marketplace flag | | Ratings & reviews | Rating value + count, overall rating | | Categories | Category breadcrumbs with positions | | Content quality | CQI (Content Quality Index), CQS (Content Quality Score) | | Product flags | isBestSeller, isNew, isBundle, isUsed, onlyMarketPlace | | Specifications | Full technical specs | | Media | Images, videos | | Visibility | Visibility score, sales rank, bestseller avg position |

Product Matches (getProductMatches)

Cross-retailer matched products — see the same product across multiple websites.

| Data | What You Get | |------|-------------| | Product identity | Name, brand, EANs, ASINs, Google category | | Cross-retailer offers | Min/max pricing across all retailers, per-website offers | | MSRP | Manufacturer suggested retail price | | Ratings & reviews | Overall aggregated rating across retailers | | Competitive positioning | Bestseller avg position, overall avg position, relevance score | | Listing status | First/last discovered dates, delisted detection | | Content quality | CQI, CQS per retailer listing | | Product flags | isBestSeller, isNew, isMostWishedFor, isFreeShipping, isBundle, isUsed | | Specifications | Full technical specs per retailer |

Google Shopping (getGoogleShopping)

Google Shopping price comparison data across sellers.

| Data | What You Get | |------|-------------| | Product identity | Name, brand, EAN, description, Google categories | | Seller offers | Multiple seller offers with price, shipping cost, seller name/URL, rating | | Ratings & reviews | Product rating and review count | | Specifications | Technical specs from Google Shopping | | Categories | Google product category taxonomy |

Installation

Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "crawlo": {
      "command": "npx",
      "args": ["-y", "crawlo-mcp"]
    }
  }
}

Restart Claude Desktop after editing.

With API key (unlimited access):

{
  "mcpServers": {
    "crawlo": {
      "command": "npx",
      "args": ["-y", "crawlo-mcp"],
      "env": {
        "CRAWLO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add crawlo -- npx -y crawlo-mcp

With API key:

CRAWLO_API_KEY=your-api-key claude mcp add crawlo -- npx -y crawlo-mcp

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CRAWLO_API_KEY | No | API key for unlimited access. Without it, you get 20 free queries per session |

How to Search

Just ask naturally:

• By keyword: "Find Samsung Galaxy S25 Ultra on mediamarkt.de"
• By brand: "Show me all Bosch products on amazon.de"
• By category: "Top-rated TVs on coolblue.nl"
• By comparison: "Compare Samsung vs LG washing machines on otto.de"
• Cross-retailer: "Where is Samsung Galaxy S24 cheapest across German retailers?"
• Google Shopping: "Find the cheapest Samsung Galaxy S25 on Google Shopping"
• By EAN: "Look up EAN 4006381333862"

Available Tools

getProductListings

Search product listings on a specific retailer website.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | website | string | Yes | Website alias (e.g. mediamarkt.de, amazon.de, coolblue.nl, otto.de, saturn.de, bol.com, elcorteingles.es) or website ID | | query | string | No | Full-text search across name, brand, EAN, ASIN, URL, category, specs | | brand / brands | string / string[] | No | Brand filter — single or multi-brand comparison | | category / categories | string / string[] | No | Category name or category IDs | | eans / asins | string[] | No | Exact product lookup by barcode or ASIN | | minPrice / maxPrice | number | No | Price range filter | | currency | string | No | Currency filter (EUR, CHF, PLN, etc.) | | minRating / maxRating | number | No | Rating filter (0–5) | | available | boolean | No | In-stock only | | isBestSeller | boolean | No | Bestsellers only | | isNew | boolean | No | New products only | | marketplace | boolean | No | Marketplace listings (true) or direct seller (false) | | seller | string | No | Filter by seller name | | sortBy | enum | No | relevance, price_asc, price_desc, rating, rating_count, bestseller, newest | | limit / offset | number | No | Pagination (default: 25, max: 100) | | includeSpecs | boolean | No | Include technical specs (default: true) | | includeOffers | boolean | No | Include all seller offers (default: true) | | returnTotal | boolean | No | Return total match count (default: false) |

getProductMatches

Cross-retailer product matching — aggregated view across multiple websites.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | region | string | Yes | Market region: de, pl, it, nl, pt, at, be, ch, tr, es | | query | string | No | Full-text keyword search | | brand / brands | string / string[] | No | Brand filter | | googleCategories | string[] | No | Google category IDs (e.g. ["404"] for TVs) | | minRating / maxRating | number | No | Rating filter (0–5) | | eans | string[] | No | EAN barcodes for exact lookup | | discoveredAfter / discoveredBefore | string | No | ISO date filter | | sortBy | enum | No | relevance, bestseller, rating, rating_count, newest, overall_position | | limit / offset | number | No | Pagination (default: 25, max: 100) | | includeSpecs / includeOffers | boolean | No | Include specs/offers (default: true) | | returnTotal | boolean | No | Return total count (default: false) |

getGoogleShopping

Google Shopping price comparison data.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | query | string | No | Full-text search across name, brand, EAN, description, specs | | brand / brands | string / string[] | No | Brand filter | | googleCategory / googleCategories | string / string[] | No | Google product category IDs | | eans | string[] | No | EAN barcodes for exact lookup | | minPrice / maxPrice | number | No | Offer price range filter | | minRating / maxRating | number | No | Rating filter (0–5) | | seller | string | No | Filter by seller name | | sortBy | enum | No | relevance, price_asc, price_desc, rating, rating_count, newest, offers_count | | limit / offset | number | No | Pagination (default: 25, max: 100) | | includeSpecs / includeOffers | boolean | No | Include specs/offers (default: true) | | returnTotal | boolean | No | Return total count (default: false) |

Supported Regions (Product Matches)

| Code | Country | |------|---------| | de | Germany | | pl | Poland | | it | Italy | | nl | Netherlands | | pt | Portugal | | at | Austria | | be | Belgium | | ch | Switzerland | | tr | Turkey | | es | Spain |

Example Websites (Product Listings)

| Alias | Retailer | |-------|----------| | mediamarkt.de | MediaMarkt Germany | | amazon.de | Amazon Germany | | otto.de | Otto | | saturn.de | Saturn Germany | | coolblue.nl | Coolblue Netherlands | | bol.com | Bol.com | | elcorteingles.es | El Corte Ingles Spain | | mediamarkt.nl | MediaMarkt Netherlands | | amazon.nl | Amazon Netherlands | | mediamarkt.pl | MediaMarkt Poland |

And 300+ more European retailer websites.

Free Tier

Crawlo MCP includes 20 free queries per session — no API key needed. After that:

• Visit crawlo.com for API key pricing
• Contact [email protected] for custom plans
• Set CRAWLO_API_KEY environment variable for unlimited access

Use Cases

• Price comparison — Compare prices across retailers for specific products
• Brand analysis — Analyze brand positioning, pricing tiers, and ratings
• Category overview — Understand market landscape for a product category
• Availability monitoring — Track which products are in stock and where
• Content quality audit — Find listings with low CQI/CQS scores
• New product tracking — Discover recently listed products
• Bestseller analysis — Understand what makes top products stand out
• Google Shopping intelligence — See all seller offers and find the best deals

License

MIT