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.

| Parameter | Type | Default | Description | | --------------------- | -------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | url | string | required | Webpage URL to scrape | | js_render | boolean | false | Enable JS rendering for SPAs and dynamic content | | premium_proxy | boolean | false | Use residential proxies to bypass anti-bot systems | | proxy_country | string | — | ISO 3166-1 alpha-2 country code (e.g. US, GB). Requires premium_proxy | | response_type | markdown | plaintext | pdf | html | markdown | Output format. html returns raw source (ZenRows default when no param is sent). Ignored when autoparse, css_extractor, outputs, or screenshot params are set | | autoparse | boolean | — | Auto-extract structured JSON from the page | | css_extractor | string | — | JSON map of CSS selectors: {"title":"h1","price":".price"} | | outputs | string | — | Comma-separated data types to extract as JSON: emails, headings, links, menus, images, videos, audios. Use * for all | | screenshot | boolean | — | Capture an above-the-fold screenshot. Returns an image | | screenshot_fullpage | boolean | — | Capture a full-page screenshot. Returns an image | | screenshot_selector | string | — | Capture a screenshot of a specific element via CSS selector | | wait_for | string | — | CSS selector to wait for before capturing. Requires js_render | | wait | number | — | Milliseconds to wait after load (max 30000). Requires js_render | | js_instructions | string | — | JSON array of browser actions. Requires js_render |

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