ScrapeOps MCP Server

An MCP (Model Context Protocol) server for accessing Amazon product search API through ScrapeOps.

Features

• Search for Amazon products by keywords
• Get detailed information about specific products by ASIN or URL
• Support for both stdio transport (for use with AI assistants like Cursor) and HTTP Streamable (SSE) transport for use with n8n and other integrations

Usage

Environment Variables

The server requires a ScrapeOps API key to function. You can configure it via:

• Environment variable: SCRAPEOPS_API_KEY=your-api-key
• For HTTP transport: URL parameter ?api_key=your-api-key

Running with stdio Transport (Default)

This is the typical way to use it with Cursor and other AI assistants:

# Using npx
npx @lucashellison/scrapeops-mcp

# If installed globally
scrapeops-mcp

Running with HTTP Streamable Transport (SSE)

For integration with n8n and similar tools:

# Using npx
npx @lucashellison/scrapeops-mcp sse

# If installed globally
scrapeops-mcp sse

The HTTP server runs on port 3000 by default. You can change the port by setting the PORT environment variable.

Cursor Integration

Add this configuration to your Cursor settings:

{
  "mcpServers": {
    "scrapeops-mcp": {
      "serverUrl": "http://localhost:3000/mcp?api_key=your-api-key"
    }
  }
}

Or using npx for direct execution:

{
  "mcpServers": {
    "scrapeops-mcp": {
      "command": "npx",
      "args": ["-y", "@lucashellison/scrapeops-mcp"],
      "env": {
        "SCRAPEOPS_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

1. amazon_product_details

Retrieves detailed information about an Amazon product by ASIN or URL, including price, description, ratings, and more.

Parameters:

• asin (optional): The ASIN of the product you want to scrape.
• url (optional): The URL of the product page you want to scrape. If a URL is provided, the URL will take priority over the ASIN.
• country (optional): The 2 letter country code where you want the product data to be scraped from. Example: US, UK, CA, DE, FR, etc.
• tld (optional): The Amazon domain TLD to scrape from (e.g., com, co.uk, ca, de, fr, etc.)

Example response:

{
  "success": true,
  "product": {
    "asin": "B09LNKXBRJ",
    "title": "Apple iPhone 13, 128GB, Starlight - Unlocked (Renewed)",
    "price": "$292.94",
    "brand": "Apple",
    "availability": "In Stock",
    "rating": 4,
    "total_ratings": 16110,
    "images": ["https://m.media-amazon.com/images/I/7199VOAdkRL.jpg"],
    "description": "...",
    "features": ["..."],
    "product_details": {}
  }
}

2. amazon_search_products

Searches for products on Amazon using a search query term and returns a list of matching products.

Parameters:

• query (required): The search query or keywords to search for on Amazon.
• country (optional): The 2 letter country code where you want to search. Example: US, UK, CA, DE, FR, etc.
• tld (optional): The Amazon domain TLD to search from (e.g., com, co.uk, ca, de, fr, etc.)

Example response:

{
  "success": true,
  "query": "iPhone",
  "total_products": 18,
  "total_ads": 2,
  "products": [
    {
      "asin": "B0DGHQQK9D",
      "title": "Apple iPhone 16 Pro Max Clear Case with MagSafe and Camera Control",
      "price": 49,
      "price_string": "$49.00",
      "url": "https://www.amazon.com/...",
      "image": "https://m.media-amazon.com/images/I/716hoQjVyvL.jpg",
      "brand": "",
      "rating": 4.2,
      "total_reviews": 2417,
      "position": 1,
      "has_prime": true,
      "is_amazon_choice": false,
      "is_best_seller": false
    }
  ],
  "ads": [
    {
      "asin": "B0DGHTNFLM",
      "title": "Apple iPhone 16 Plus Clear Case with MagSafe and Camera Control",
      "url": "https://www.amazon.com/...",
      "image": "https://m.media-amazon.com/images/I/61AXS9mQr6L.jpg",
      "brand": "",
      "rating": 4.6,
      "total_reviews": 0,
      "type": "top_stripe_ads",
      "has_prime": false,
      "is_amazon_choice": false,
      "is_best_seller": false
    }
  ]
}

License

MIT