What This Plugin Does

This plugin brings the full power of Bright Data's infrastructure directly into your OpenClaw agent — no manual API wiring, no proxies to configure. Install once, and your agent gains:

• Real-time web search via Google, Bing, and Yandex with geo-targeting
• Bot-bypass scraping through Bright Data Web Unlocker — handles CAPTCHAs, JS rendering, and rate limits automatically
• Full browser automation via a real Chromium instance routed through Bright Data's residential proxy network
• 50+ structured data tools for Amazon, LinkedIn, Instagram, TikTok, YouTube, Reddit, and more — no parsing required

Install

openclaw plugins install @brightdata/brightdata-plugin

Configure

Get your API token at brightdata.com → Account → API Token.

# Option A — environment variable (recommended for local dev)
export BRIGHTDATA_API_TOKEN=your_token_here

# Option B — OpenClaw config (recommended for persistent setups)
openclaw config set plugins.entries.brightdata.config.webSearch.apiKey your_token_here

The plugin automatically creates two proxy zones on first use: mcp_unlocker (Web Unlocker) and mcp_browser (Browser API). No manual zone setup required.

To use existing zones instead:

export BRIGHTDATA_UNLOCKER_ZONE=my_existing_zone
export BRIGHTDATA_BROWSER_ZONE=my_existing_browser_zone

Tools Overview

66 tools across five categories:

| Category | Count | What it does | |----------|------:|-------------| | Search | 2 | Real-time SERP results from Google, Bing, Yandex | | Scrape | 1 | Full-page extraction with bot bypass | | Batch | 2 | Parallel search and scrape up to 5 at a time | | Browser | 14 | Full browser control via residential proxies | | Web Data | 47 | Structured data from 47 platforms |

Search

The plugin registers automatically as an OpenClaw web search provider — it appears alongside other providers in the search provider selection UI.

brightdata_search

Search Google, Bing, or Yandex and get structured results back.

| Parameter | Type | Description | |-----------|------|-------------| | query | string | Required. Search query | | engine | "google" \| "bing" \| "yandex" | Search engine (default: google) | | count | number | Results to return, 1–10 | | cursor | string | Pagination cursor for next page | | geo_location | string | 2-letter ISO country code (e.g. "us", "de") | | timeoutSeconds | number | Request timeout override |

brightdata_search_batch

Run up to 5 search queries in parallel. Partial failures are returned inline without failing the whole batch.

Scrape

brightdata_scrape

Fetch any page through Bright Data Web Unlocker. Works on bot-protected sites, JavaScript-rendered pages, and geo-restricted content.

| Parameter | Type | Description | |-----------|------|-------------| | url | string | Required. HTTP/HTTPS URL to scrape | | extractMode | "markdown" \| "text" \| "html" | Output format (default: markdown) | | maxChars | number | Maximum characters to return (min: 100) | | timeoutSeconds | number | Request timeout override |

brightdata_scrape_batch

Scrape up to 5 URLs in parallel with the same extraction options.

Browser Automation

Full Chromium browser control routed through Bright Data's residential proxy network. Sessions are automatically scoped per user context and idle-timeout after 10 minutes.

| Tool | Description | |------|-------------| | brightdata_browser_navigate | Navigate to a URL (optional country routing) | | brightdata_browser_snapshot | Capture an ARIA snapshot with interactive element refs | | brightdata_browser_click | Click an element by its snapshot ref | | brightdata_browser_type | Type into a field by ref (optional Enter to submit) | | brightdata_browser_fill_form | Fill multiple form fields in a single operation | | brightdata_browser_screenshot | Take a screenshot (viewport or full page) | | brightdata_browser_get_html | Get current page HTML | | brightdata_browser_get_text | Get current page text content | | brightdata_browser_scroll | Scroll to bottom of page | | brightdata_browser_scroll_to | Scroll to a specific element by ref | | brightdata_browser_wait_for | Wait for an element to become visible | | brightdata_browser_network_requests | List network requests since page load | | brightdata_browser_go_back | Navigate back | | brightdata_browser_go_forward | Navigate forward |

Web Data — 50+ Platforms

Structured data from real pages via Bright Data datasets. Each tool accepts a url or keyword and returns clean, typed JSON — no scraping, no parsing.

| Tool | Data | |------|------| | brightdata_amazon_product | Product details, pricing, specs | | brightdata_amazon_product_reviews | Customer reviews and ratings | | brightdata_amazon_product_search | Search results with rankings | | brightdata_walmart_product | Product details and availability | | brightdata_walmart_seller | Seller profile and metrics | | brightdata_ebay_product | Listing details and bids | | brightdata_homedepot_products | Product catalog and pricing | | brightdata_zara_products | Fashion catalog data | | brightdata_etsy_products | Handmade and vintage listings | | brightdata_bestbuy_products | Electronics catalog and deals |

| Tool | Data | |------|------| | brightdata_linkedin_person_profile | Full person profile | | brightdata_linkedin_company_profile | Company overview and stats | | brightdata_linkedin_job_listings | Open positions with details | | brightdata_linkedin_posts | Post content and engagement | | brightdata_linkedin_people_search | People search results | | brightdata_crunchbase_company | Funding, investors, founders | | brightdata_zoominfo_company_profile | Company intelligence data |

Instagram | Tool | Data | |------|------| | brightdata_instagram_profiles | Profile stats and bio | | brightdata_instagram_posts | Post content and engagement | | brightdata_instagram_reels | Reel metadata and views | | brightdata_instagram_comments | Comment threads |

Facebook | Tool | Data | |------|------| | brightdata_facebook_posts | Post content and reactions | | brightdata_facebook_marketplace_listings | Marketplace items | | brightdata_facebook_company_reviews | Page reviews and ratings | | brightdata_facebook_events | Event details and attendance |

TikTok | Tool | Data | |------|------| | brightdata_tiktok_profiles | Creator profile and stats | | brightdata_tiktok_posts | Video content and metrics | | brightdata_tiktok_shop | TikTok Shop product data | | brightdata_tiktok_comments | Comment threads |

X (Twitter) | Tool | Data | |------|------| | brightdata_x_posts | Post content and metrics | | brightdata_x_profile_posts | Profile post history |

YouTube & Reddit | Tool | Data | |------|------| | brightdata_youtube_profiles | Channel stats and info | | brightdata_youtube_videos | Video details and metrics | | brightdata_youtube_comments | Comment threads | | brightdata_reddit_posts | Post content and scores |

| Tool | Data | |------|------| | brightdata_google_maps_reviews | Location reviews and ratings | | brightdata_google_shopping | Shopping results and prices | | brightdata_google_play_store | App details and reviews | | brightdata_apple_app_store | App details and reviews |

| Tool | Data | |------|------| | brightdata_reuter_news | Reuters news articles | | brightdata_yahoo_finance_business | Company financials and news | | brightdata_github_repository_file | Repository file contents |

| Tool | Data | |------|------| | brightdata_zillow_properties_listing | Property listings and estimates | | brightdata_booking_hotel_listings | Hotel listings and pricing |

| Tool | Data | |------|------| | brightdata_chatgpt_ai_insights | ChatGPT responses | | brightdata_grok_ai_insights | Grok responses | | brightdata_perplexity_ai_insights | Perplexity responses |

Configuration Reference

All settings can be provided via environment variable or OpenClaw config. Environment variables take priority.

| Setting | Environment Variable | Config Path | Default | |---------|---------------------|-------------|---------| | API Token | BRIGHTDATA_API_TOKEN | ...webSearch.apiKey | required | | Base URL | BRIGHTDATA_BASE_URL | ...webSearch.baseUrl | https://api.brightdata.com | | Unlocker Zone | BRIGHTDATA_UNLOCKER_ZONE | ...webSearch.unlockerZone | mcp_unlocker | | Browser Zone | BRIGHTDATA_BROWSER_ZONE | ...webSearch.browserZone | mcp_browser | | Request Timeout | — | ...webSearch.timeoutSeconds | 30s search / 60s scrape | | Polling Timeout | — | ...webSearch.pollingTimeoutSeconds | 600s |

Config paths are prefixed with plugins.entries.brightdata.config.

Plugin Management

# Install
openclaw plugins install @brightdata/brightdata-plugin

# Verify installation and loaded tools
openclaw plugins inspect brightdata

# Update to latest version
openclaw plugins update brightdata

# Temporarily disable
openclaw plugins disable brightdata

# Re-enable
openclaw plugins enable brightdata

# Uninstall
openclaw plugins uninstall brightdata

Requirements

• OpenClaw installed and running
• A Bright Data account with API token
• Node.js 22+ (managed by OpenClaw)

License

MIT © Bright Data