`brightdata_serp`

Pack: bright-data · Endpoint: https://gateway.pipeworx.io/bright-data/mcp

Run a Google search through the Bright Data SERP API and return parsed organic results (rank, title, link, description) with geo-targeting. Uses the same Bright Data request API with a SERP-type zone — create a SERP API zone in your Bright Data dashboard and pass its name as zone (Web Unlocker zones return raw HTML for Google). BYOK: Bright Data API token via _apiKey; pay-per-request pricing on the Bright Data side. Example: brightdata_serp({ query: “best espresso machine”, zone: “serp_api1”, country: “us”, _apiKey: “your-brightdata-token” })

Parameters

Name	Type	Required	Description
`query`	string	yes	The Google search query, e.g. “best espresso machine 2026”
`zone`	string	no	Your SERP API zone name from the Bright Data control panel (a SERP-type zone is required for parsed Google results). Default ”${DEFAULT_SERP_ZONE}” — the typical auto-generated name; check your dashboard for the exact name.
`country`	string	no	Two-letter country code for localized results (sent as Google’s `gl` parameter), e.g. “us”, “gb”, “jp”. Optional.
`num`	number	no	Maximum organic results to return (client-side cap; Google serves ~10 per page — use `start` for deeper pages). Default 10.
`start`	number	no	Pagination offset: 0 = first page (default), 10 = second page, 20 = third.
`_apiKey`	string	yes	Your Bright Data API token (account settings or zone Overview tab). Requires a Bright Data account with a SERP API zone; sign up at https://brightdata.com

Example call

Arguments

{
  "query": "best espresso machine 2026",
  "_apiKey": "your-brightdata-token"
}

curl

curl -X POST https://gateway.pipeworx.io/bright-data/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"brightdata_serp","arguments":{"query":"best espresso machine 2026","_apiKey":"your-brightdata-token"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('brightdata_serp', {
  "query": "best espresso machine 2026",
  "_apiKey": "your-brightdata-token"
});

More examples

{
  "query": "restaurants near me",
  "_apiKey": "your-brightdata-token",
  "zone": "serp_api1",
  "country": "us",
  "num": 20,
  "start": 10
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "bright-data": {
      "url": "https://gateway.pipeworx.io/bright-data/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

brightdata_serp