> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zenrows.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ZenRows MCP Integration for Claude Code

> Learn how to set up the ZenRows MCP server in Claude Code to scrape and extract structured web data from your terminal or workspace.

## Before You Start

You need:

<Columns cols={2}>
  <Card icon="user" href="https://app.zenrows.com/register" title="ZenRows Account">A **ZenRows account**</Card>
  <Card icon="key" href="https://app.zenrows.com/dashboard" title="ZenRows API Key">Your **ZenRows API key**</Card>
</Columns>

<Card icon="code" href="https://nodejs.org/en/download/" title="Node.js">Latest version of **Node.js** installed on your machine</Card>

## Setup

### Option A: Terminal command (recommended)

Run the following command in your terminal, replacing `YOUR_ZENROWS_API_KEY` with your actual API key:

```bash theme={null}
claude mcp add zenrows -e ZENROWS_API_KEY=YOUR_ZENROWS_API_KEY -- npx -y @zenrows/mcp
```

### Option B: Project configuration file

Add ZenRows to your project's `.mcp.json` file:

```json theme={null}
{
  "mcpServers": {
    "zenrows": {
      "command": "npx",
      "args": ["-y", "@zenrows/mcp"],
      "env": {
        "ZENROWS_API_KEY": "YOUR_ZENROWS_API_KEY"
      }
    }
  }
}
```

## Start scraping

Ask Claude Code to scrape a webpage or automate a browser workflow in plain English:

```
Get the product names and prices from https://www.scrapingcourse.com/ecommerce/.
```

```
Scrape https://www.scrapingcourse.com/antibot-bypass using Premium Proxies.
```

```
Fetch https://www.scrapingcourse.com/javascript-rendering/ with JavaScript rendering enabled and return the page as Markdown.
```

```
Open https://scrapingcourse.com/login in a browser, fill in the credentials, click submit, then extract the account details.
```

## Troubleshooting

**The `scrape` tool is not available**

If you used Option A, confirm the command ran without errors. If you used Option B, confirm the `.mcp.json` file is in the root of your project and contains valid JSON.

**Page content is missing or incomplete**

The page likely loads content dynamically. Ask Claude to enable JavaScript rendering:

```
Scrape https://www.scrapingcourse.com/javascript-rendering/ with `js_render: true`.
```

**Requests return a 403 or bot detection page**

Ask Claude to use Premium Proxies:

```
Scrape https://www.scrapingcourse.com/antibot-bypass using `premium_proxy: true`.
```

For more troubleshooting options, see the [ZenRows MCP overview](https://docs.zenrows.com/integrations/mcp/mcp-overview#troubleshooting).
