zenrows-mcp

Model Context Protocol server for the ZenRows Universal Scraper API.
Give any MCP-compatible AI assistant the ability to scrape any webpage — including JavaScript-rendered content and anti-bot protected sites.

Quick Start

Claude Code

claude mcp add zenrows -e ZENROWS_API_KEY=YOUR_API_KEY -- npx -y @zenrows/mcp

Or ask your AI assistant naturally once configured:

Scrape https://example.com and summarize the content.

Tool

scrape

Fetches a webpage and returns its content as clean markdown (default), plaintext, raw HTML, PDF, structured JSON, or a screenshot. See the ZenRows API docs for full parameter reference.

When to use which options

Content doesn't appear or page is blank
→ Enable js_render: true. The page likely uses React, Vue, or Angular.

Getting 403 or blocked errors
→ Add premium_proxy: true. For geo-restricted content, also set proxy_country.

Content loads after a delay or interaction
→ Use wait_for (CSS selector) or wait (milliseconds) with js_render: true.
→ For clicks or form inputs before scraping, use js_instructions.

Only need specific data, not the full page
→ Use css_extractor with a JSON map of selectors for precise extraction.
→ Use autoparse for structured pages like products or articles.
→ Use outputs to pull links, emails, images, or other content types.

Need to verify what the page looks like
→ Use screenshot or screenshot_fullpage for visual debugging.
→ Use screenshot_selector to capture a specific element.

Installation

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "zenrows": {
      "command": "npx",
      "args": ["-y", "@zenrows/mcp"],
      "env": {
        "ZENROWS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add zenrows -e ZENROWS_API_KEY=YOUR_API_KEY -- npx -y @zenrows/mcp

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "zenrows": {
      "command": "npx",
      "args": ["-y", "@zenrows/mcp"],
      "env": {
        "ZENROWS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "zenrows": {
      "command": "npx",
      "args": ["-y", "@zenrows/mcp"],
      "env": {
        "ZENROWS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "zenrows": {
      "command": "npx",
      "args": ["-y", "@zenrows/mcp"],
      "env": {
        "ZENROWS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

Edit .vscode/mcp.json in your project:

{
  "servers": {
    "zenrows": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@zenrows/mcp"],
      "env": {
        "ZENROWS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Zed

Edit ~/.config/zed/settings.json:

{
  "context_servers": {
    "zenrows": {
      "command": {
        "path": "npx",
        "args": ["-y", "@zenrows/mcp"],
        "env": {
          "ZENROWS_API_KEY": "YOUR_API_KEY"
        }
      }
    }
  }
}

JetBrains IDEs

Go to Settings → Tools → AI Assistant → Model Context Protocol and add:

{
  "mcpServers": {
    "zenrows": {
      "command": "npx",
      "args": ["-y", "@zenrows/mcp"],
      "env": {
        "ZENROWS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Examples

Once configured, ask your AI assistant naturally:

Scrape the pricing page at https://zenrows.com/pricing and summarize the plans.

Fetch https://example.com/ — it's a React SPA, so enable JS rendering.

Get the top 5 results from https://www.scrapingcourse.com/ecommerce/ and extract just the product names and prices.

Take a full-page screenshot of https://news.ycombinator.com to see the current layout.

Scrape https://protected-site.com — it keeps blocking me, use premium proxies.

Development

git clone https://github.com/ZenRows/zenrows-mcp
cd zenrows-mcp
npm install
cp .env.example .env   # add your API key
npm run dev            # run with .env loaded (requires Node 20.6+)
npm run build          # compile to dist/
npm run inspect        # open MCP inspector UI