Security News
The Hidden Blast Radius of the Axios Compromise
The Axios compromise shows how time-dependent dependency resolution makes exposure harder to detect and contain.
By Ahmad Nassri - Apr 01, 2026
New Research: Supply Chain Attack on Axios Pulls Malicious Dependency from npm.Details → →
@brightdata/brightdata-plugin
Advanced tools
Bright Data Plugin for OpenClaw
Web search · Scraping · Browser automation · 50+ structured data tools
Powered by Bright Data — the world's leading web data platform
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) andmcp_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.
E-commerce (10 tools)
| 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 |
Professional Networks (7 tools)
| 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 |
Social Media (17 tools)
| 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 |
| 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 |
Maps, Shopping & Apps (4 tools)
| 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 |
Finance, News & Code (3 tools)
| Tool | Data |
|---|---|
brightdata_reuter_news | Reuters news articles |
brightdata_yahoo_finance_business | Company financials and news |
brightdata_github_repository_file | Repository file contents |
Real Estate & Travel (2 tools)
| Tool | Data |
|---|---|
brightdata_zillow_properties_listing | Property listings and estimates |
brightdata_booking_hotel_listings | Hotel listings and pricing |
AI Insights (3 tools)
| 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
FAQs
OpenClaw Bright Data plugin
We found that @brightdata/brightdata-plugin demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 7 open source maintainers collaborating on the project.
Package last updated on 30 Mar 2026
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Related posts
Research
Supply Chain Attack on Axios Pulls Malicious Dependency from npm
A supply chain attack on Axios introduced a malicious dependency, plain-crypto-js@4.2.1, published minutes earlier and absent from the project’s GitHub releases.
By Socket Research Team - Mar 31, 2026
Research
TeamPCP Compromises Telnyx Python SDK to Deliver Credential-Stealing Malware
Malicious versions of the Telnyx Python SDK on PyPI delivered credential-stealing malware via a multi-stage supply chain attack.
By Socket Research Team - Mar 27, 2026