crawlo-premium-mcp

A premium MCP (Model Context Protocol) server that connects Claude to the Crawlo e-commerce monitoring API. Includes GFK/MM sales data, scoring analytics, and client-specific intelligence — plus everything in crawlo-mcp. Search, compare, and analyze product data across 10 European markets — directly from Claude Desktop or any MCP-compatible client.

One MCP server. Six conversations. Every team gets smarter.

What Data Is Available?

Each product match returns rich, actionable intelligence:

| Data | What You Get | |------|-------------| | Product identity | Name, brand, EANs, ASINs, Google category, breadcrumbs | | Pricing & offers | Min/max price across retailers, seller name, website, currency, availability, discount %, marketplace vs direct, shipping details | | MSRP | Manufacturer suggested retail price | | Ratings & reviews | Overall rating (value + count), per-retailer review data | | Competitive positioning | Bestseller avg position, overall avg position across retailers | | Amazon intelligence | Sales rank, estimated sales count, Amazon-specific category ranking | | Listing status | First/last time discovered, delisted detection | | Content quality | CQI (images, videos, description scores), CQS (title, features, key features, cross-selling, accessories, 360 images) | | Product flags | isBestSeller, isNew, isMostWishedFor, isFreeShipping, isBundle, isUsed | | Specifications | Full technical specs (screen size, weight, RAM, energy class, etc.) | | Marketplace sellers | Marketplace offers with seller info, country, pricing | | GPSR compliance | Manufacturer name, address, email, website (EU product safety) | | Inventory | Stock level indicators per retailer |

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-premium": {
      "command": "npx",
      "args": ["-y", "crawlo-premium-mcp"],
      "env": {
        "CRAWLO_API_KEY": "your-api-key-here",
        "CRAWLO_API_URL": "https://your-api-url.com"
      }
    }
  }
}

Restart Claude Desktop after editing.

Claude Code

CRAWLO_API_KEY=your-api-key-here CRAWLO_API_URL=https://your-api-url.com claude mcp add crawlo-premium -- npx -y crawlo-premium-mcp

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CRAWLO_API_KEY | Yes | API key for authenticating with the Crawlo API | | CRAWLO_API_URL | Yes | Base URL for the Crawlo API |

Manual / Development

git clone https://github.com/anthropics/crawlo-premium-mcp.git
cd crawlo-premium-mcp
npm install
node mcp-server.js

How to Search

You do NOT need an EAN or brand to search. Just ask naturally:

• By keyword: "Find me the Samsung Galaxy S25 Ultra in Germany"
• By brand: "Show me all Bosch products in Poland"
• By category: "Top-rated TVs in France"
• By comparison: "Compare Samsung vs LG washing machines in DE"
• By date: "New products launched this month in Italy"
• By EAN: "Look up EAN 4006381333862"

The query field searches across product names, brands, categories, EANs, ASINs, URLs, and specification values — so a simple product name is enough.

Who Is This For?

Strategic Leadership — CEO / Commercial Directors

Cross-category, cross-geo market intelligence without waiting for reports.

• "How is our overall price positioning vs Amazon across all categories in DE and PL?"
• "Show me the top 10 brands where we're losing ground based on pricing and availability."
• "What's the market trend for large appliances pricing across Europe?"
• "Which categories have the biggest competitive gap vs top 3 online retailers?"

Category Managers

Deep visibility into specific categories — brands, assortment gaps, new launches.

• "Top brands for semi-integrated dishwashers 60cm — show me prices and ratings."
• "Which TV products 55-65 inch are bestsellers in DE? Include specs."
• "Compare Samsung Galaxy S25 pricing vs all competitors in FR."
• "Which brands launched new SKUs in air conditioning in the last 30 days?"
• "Show me all laptops where content quality score is low — missing images or videos."

Pricing Managers

Detect gaps, compare competitor pricing, protect margin in real-time.

• "Which Samsung products are priced highest vs the market average in DE?"
• "Show me the cheapest offers for EAN 4006381333862 across all sellers."
• "Find all products in washing machines sorted by bestseller rank in PL — include offers."
• "Which products have the biggest gap between MSRP and lowest market price?"
• "List products with free shipping offers in the UK sorted by rating."

Marketplace Managers

Amazon and marketplace intelligence — sales rank, seller dynamics, competitive positioning.

• "Show me bestseller products in small appliances in DE with rating above 4."
• "Compare marketplace vs direct pricing for Sony headphones in UK."
• "Which products have the most marketplace sellers in DE?"
• "Find products with high Amazon sales rank in electronics in FR."
• "Which sellers are offering the lowest prices on Samsung TVs?"

Private Label / Own Brand Managers

Find whitespace, benchmark against branded products, spot Private Label opportunities.

• "Compare our brand X products vs branded equivalents — show ratings and pricing."
• "Which categories have products with low brand concentration and high demand?"
• "Find products rated below 3.5 in kitchen appliances — opportunity for a better product."
• "Show me the price gap between top brands and lesser-known brands in monitors."
• "Which new products have no reviews yet in the last 60 days?"

AI / Data Team

Build and scale AI agents on top of Crawlo data.

• "Count total Samsung products in DE — just the total, no results."
• "Pull 100 products in category 404 with full specs and offers for analysis."
• "Find all products discovered in the last 7 days in FR, sorted by newest."
• "Show me products with GPSR compliance data in DE."

Available Tools

getProductMatches

Search and analyze products across e-commerce websites.

Parameters

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | region | string | Yes | Market region code (see supported regions) | | query | string | No | Keyword search — works on name, brand, category, EAN, ASIN, specs. Just type a product name | | brand | string | No | Single brand filter (e.g. sony) | | brands | string[] | No | Multi-brand comparison (e.g. ["samsung", "lg"]) | | googleCategories | string[] | No | Google category IDs (e.g. ["404"] for TVs) | | minRating | number | No | Minimum rating (0-5) | | maxRating | number | No | Maximum rating (0-5) | | eans | string[] | No | EAN barcodes for exact lookup | | discoveredAfter | string | No | ISO date — products discovered after this date | | discoveredBefore | string | No | ISO date — products discovered before this date | | sortBy | string | No | relevance, bestseller, rating, rating_count, newest, overall_position | | limit | number | No | Max results (default: 10, max: 100). Use 0 with returnTotal for count only | | offset | number | No | Skip N results for pagination | | includeSpecs | boolean | No | Include technical specifications (default: true) | | includeOffers | boolean | No | Include pricing/offers from retailers (default: true) | | returnTotal | boolean | No | Include total match count in response (default: false) |

Supported Regions

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

Share with Your Team

Want to give your colleagues access to Crawlo MCP? Share the API key and one of these setup options:

Option 1: Claude Code (one command)

CRAWLO_API_KEY=your-api-key CRAWLO_API_URL=https://your-api-url.com claude mcp add crawlo-premium -- npx -y crawlo-premium-mcp

Option 2: Claude Desktop

Add this to the config file:

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

{
  "mcpServers": {
    "crawlo-premium": {
      "command": "npx",
      "args": ["-y", "crawlo-premium-mcp"],
      "env": {
        "CRAWLO_API_KEY": "your-api-key",
        "CRAWLO_API_URL": "https://your-api-url.com"
      }
    }
  }
}

Restart Claude Desktop after editing.

Option 3: Share the npm package link

https://www.npmjs.com/package/crawlo-premium-mcp

For API keys or custom plans, contact [email protected].

Free Trial

Crawlo MCP includes 10 free queries per session. For unlimited access:

• Visit crawlo.com for pricing
• Contact [email protected] for custom plans

License

MIT