Skip to main content

​
Before You Start

You need:

ZenRows Account

A ZenRows account

ZenRows API Key

Your ZenRows API key

Node.js

Latest version of Node.js installed on your machine

Windsurf

Windsurf installed

​
Setup

1

Step 1: Open the configuration file

Open the Windsurf MCP configuration file:
~/.codeium/windsurf/mcp_config.json
If the file does not exist yet, create it.
2

Step 2: Add the ZenRows MCP server

Paste the following into the configuration file, replacing YOUR_ZENROWS_API_KEY with your actual API key:
{
"mcpServers": {
    "zenrows": {
        "command": "npx",
        "args": ["-y", "@zenrows/mcp"],
        "env": {
            "ZENROWS_API_KEY": "YOUR_ZENROWS_API_KEY"
            }
        }
    }
}
3

Step 3: Restart Windsurf

Save the file and restart Windsurf to load the new configuration.

​
Start scraping

Ask Windsurf’s AI assistant to scrape a webpage 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.

​
Troubleshooting

The scrape tool is not available Confirm the configuration file is saved at ~/.codeium/windsurf/mcp_config.json and contains valid JSON. You can validate the JSON syntax at jsonlint.com. Then restart Windsurf. Page content is missing or incomplete The page likely loads content dynamically. Ask the assistant to enable JavaScript rendering: 
Scrape https://www.scrapingcourse.com/javascript-rendering/ with `js_render: true`.
Requests return a 403 or bot detection page Ask the assistant to use Premium Proxies: 
Scrape https://www.scrapingcourse.com/antibot-bypass using `premium_proxy: true`.
For more troubleshooting options, see the ZenRows MCP overview.