How to integrate Brightdata MCP with OpenClaw

Connect OpenClaw to Brightdata MCP. Download all product listings from this ecommerce site, check crawl status for your recent job, and more using natural language, with authentication handled for you.

Brightdata logoBrightdata
Api Key

Brightdata is a leading web data platform offering advanced scraping, SERP APIs, and anti-bot tools. It lets you collect public web data at scale, bypassing blocks and friction.

23 Tools

Introduction

OpenClaw is the fastest growing agent harness out there, which can work 24/7 to automate almost any kind of tasks. However, its capabilities are limited to the tools it has access to. Composio allows your OpenClaw to access Brightdata with authentication management handled for you. You can execute actions on Brightdata via your favorite OpenClaw interface (Telegram, WhatsApp, TUI, etc), whichever you prefer.

Also integrate Brightdata with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • Programmatic tool calling allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Handling Large tool responses out of LLM context to minimize context rot.
  • Dynamic just-in-time access to 20,000 tools across 1500+ other Apps for cross-app workflows. It loads the tools you need, so LLMs aren't overwhelmed by tools you don't need.

How to install Brightdata with OpenClaw

Using Composio API Key and Setup Prompt

Copy the setup prompt from the OpenClaw dashboard
  • Run it in your OpenClaw chat interface.
  • Authenticate Brightdata from the dashboard
  • Go back to your OpenClaw interface and start asking questions.

Using OpenClaw/Composio Plugin

1. Install OpenClaw Composio plugin

bash
openclaw plugins install @composio/openclaw-plugin

2. Copy the API Key from dashboard.composio.dev

3. Setup OpenClaw Config

bash
openclaw config set plugins.entries.composio.config.consumerKey "ck_your_key_here"

4. Restart OpenClaw

bash
openclaw gateway restart

5. Go to your chat interface and start asking questions.

6. When prompted, authenticate the app and you're all set.

How It Works

The plugin connects to Composio's MCP server at https://connect.composio.dev/mcp and registers all available tools directly into the OpenClaw agent. Tools are called by name — no extra search or execute steps needed.

If a tool returns an auth error, the agent will prompt you to connect that toolkit at dashboard.composio.dev.

Configuration

bash
{
  "plugins": {
    "entries": {
      "composio": {
        "enabled": true,
        "config": {
          "consumerKey": "ck_your_key_here"
        }
      }
    }
  }
}
OptionDescriptionDefault
enabledEnable or disable the plugintrue
consumerKeyYour Composio consumer key (ck_...)—
mcpUrlMCP server URL (advanced)https://connect.composio.dev/mcp

What is the Brightdata MCP server, and what's possible with it?

The Brightdata MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Brightdata account. It provides structured and secure access to Brightdata’s web data platform, so your agent can trigger site crawls, run SERP searches, filter and download datasets, and manage proxy endpoints on your behalf.

  • Automated site crawling and extraction: Start large-scale crawl jobs across multiple web pages or entire domains, letting your agent collect structured data from the internet with just a prompt.
  • Access to pre-made marketplace scrapers: Browse and select from Brightdata’s collection of pre-built scrapers for popular websites, making it easy to gather structured data without building your own scrapers from scratch.
  • Filtered dataset generation and download: Apply custom filters to datasets, check crawl job status, and retrieve the exact data you need by downloading processed results once ready.
  • Powerful SERP and web unlocker tools: Perform real-time SERP searches across various engines and leverage web unlocker zones to bypass anti-bot protections and scrape challenging websites.
  • Proxy zone and location management: List available proxy zones, cities, and countries to configure how and where your data collection jobs run, optimizing for speed and success.

Conclusion

You've successfully integrated Brightdata with OpenClaw using Composio plugin. Now interact with Brightdata directly from your terminal, Web UI, or any messenger app using natural language commands.

Key benefits of this setup:

  • Seamless integration across TUI, Web UIs, and Messenger apps like Telegram, WhatsApp, Slack, etc.
  • Natural language commands for Brightdata operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1500+ apps for cross-app workflows
  • Programmatic tool calling for complex tool chaining

Next steps:

  • Try asking OpenClaw to perform various Brightdata operations
  • Explore cross-app workflows by connecting more toolkits like Calendar, Slack, Notion, etc.
  • Build complex automation scripts that leverage OpenClaw's 24/7 running capabilities
TOOLS

Supported Tools

Every Brightdata action and event your agent gets out of the box.

Start Site Crawl

Start an asynchronous dataset or site crawl.

Create Safe Zone

Create a durable SERP API or Scraping Browser zone using a fixed safe plan.

List Marketplace Datasets

List pre-built datasets in Bright Data's marketplace for structured scraping.

Filter Dataset

Create a billable filtered marketplace-dataset snapshot.

Get Customer Balance

Get current and pending Bright Data account balances.

Get Dataset Metadata

Retrieve field definitions for a Bright Data marketplace dataset.

Get Deep Lookup Results

Retrieve enriched records plus available progress, cost, and provider metadata for a completed Deep Lookup request.

Get Deep Lookup Status

Check a Deep Lookup request's status, progress, cost, and provider metadata.

List Available Cities

List static-network cities available for a country and proxy pool type.

List Available Countries

List country codes available for each static proxy zone type.

Get SERP Results

Retrieve JSON or raw results for an asynchronous BRIGHTDATA_SERP_SEARCH request.

Download Snapshot Results

Download a completed dataset snapshot.

Check Snapshot Status

Check whether a dataset snapshot is running, ready, or failed before downloading it.

Get Web Archive Search

Get a Web Archive search's status and its matching-file, dump-size-in-bytes, and dump-cost-in-USD estimates.

Get Zone Bandwidth

Get uploaded, downloaded, and total byte usage for one zone and date range.

Get Zone Cost

Get invoice-aligned billed cost and bandwidth for one zone and date range.

List Scraper Studio Scrapers

List account-owned Scraper Studio scrapers and discover collector IDs.

List Unlocker Zones

List configured Web Unlocker zones and their types for protected-URL scraping.

Scrape Data Synchronously

Scrape up to 20 input objects synchronously.

Search Web Archive

Search Bright Data's Web Archive and estimate matching files, dump size in bytes, and dump cost in USD.

Search SERP

Submit an asynchronous SERP search and return its response_id.

Start Deep Lookup

Start an asynchronous Deep Lookup research request and return its request_id.

Scrape Protected URL

Scrape a public URL through Web Unlocker when ordinary requests are blocked or require JavaScript rendering.

FAQ

Frequently asked questions

With a standalone Brightdata MCP server, the agents and LLMs can only access a fixed set of Brightdata tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Brightdata and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. OpenClaw fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Brightdata tools.

Yes, absolutely. You can configure which Brightdata scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Brightdata data and credentials are handled as safely as possible.

Start with Brightdata.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Brightdata tool your agent needs.Free to start.

Start building