← Back to Skills Marketplace
meirkad

Bright Data

by MeirKaD · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2879
Downloads
1
Stars
14
Active Installs
1
Versions
Install in OpenClaw
/install bright-data
Description
Web scraping and search via Bright Data API. Requires BRIGHTDATA_API_KEY and BRIGHTDATA_UNLOCKER_ZONE. Use for scraping any webpage as markdown (bypassing bot detection/CAPTCHA) or searching Google with structured results.
README (SKILL.md)

Bright Data - Web Scraping & Search

Direct API access to Bright Data's Web Unlocker and SERP APIs.

Setup

1. Get your API Key: Get a key from Bright Data Dashboard.

2. Create a Web Unlocker zone: Create a zone at brightdata.com/cp by clicking "Add" (top-right), selecting "Unlocker zone".

3. Set environment variables:

export BRIGHTDATA_API_KEY="your-api-key"
export BRIGHTDATA_UNLOCKER_ZONE="your-zone-name"

Usage

Google Search

Search Google and get structured JSON results (title, link, description).

bash scripts/search.sh "query" [cursor]
  • cursor: Optional page number for pagination (0-indexed, default: 0)

Web Scraping

Scrape any webpage as markdown. Bypasses bot detection and CAPTCHA.

bash scripts/scrape.sh "url"

Output Formats

Search Results

Returns JSON with structured organic array:

{
  "organic": [
    {"link": "...", "title": "...", "description": "..."}
  ]
}

Scrape Results

Returns clean markdown content from the webpage.

Usage Guidance
What to check before installing: - Confirm the publisher/owner (source/homepage is missing). If you don't trust the owner, don't install. - The SKILL.md and scripts require BRIGHTDATA_API_KEY and BRIGHTDATA_UNLOCKER_ZONE; the registry metadata did not declare these — ask the publisher to correct the metadata so you know what secrets you'll be asked for. - Ensure you intend to give Bright Data an API key: any URL you ask the skill to scrape will be sent to Bright Data and they will receive the page content — this may expose private URLs or sensitive data and will incur usage charges. Use a limited-scope or expendable key if possible, and monitor usage/billing. - The scripts require curl and jq on PATH but the manifest didn't list them; verify you have these binaries or the scripts will fail. - If you need stronger isolation, run the skill in a network-isolated environment or with restricted credentials. Consider asking the publisher for a version that documents required binaries/credentials and includes a homepage or source link.
Capability Analysis
Type: OpenClaw Skill Name: bright-data Version: 1.0.0 The skill bundle is benign. It provides web scraping and search functionality via the Bright Data API, as described in SKILL.md. The shell scripts (`scripts/scrape.sh`, `scripts/search.sh`) correctly handle user input by using `jq` for safe JSON payload construction and URL encoding (`jq -sRr @uri`), preventing command injection. They communicate with the legitimate `https://api.brightdata.com/request` endpoint, sending only the necessary `BRIGHTDATA_API_KEY` and `BRIGHTDATA_UNLOCKER_ZONE` environment variables. There is no evidence of prompt injection against the agent, data exfiltration beyond the stated purpose, malicious execution, persistence, or obfuscation.
Capability Assessment
Purpose & Capability
The SKILL.md and the included scripts clearly require BRIGHTDATA_API_KEY and BRIGHTDATA_UNLOCKER_ZONE and perform Bright Data API requests — that is coherent with the stated purpose. However the registry metadata lists no required env vars or primary credential, which is inconsistent and misleading (the API key should be declared as the primary credential).
Instruction Scope
The instructions and scripts are narrowly scoped: they build a Bright Data request and POST to https://api.brightdata.com/request, then output parsed JSON or markdown. The scripts do not reference unrelated files, system configuration, or external endpoints other than Bright Data. Note: they will send arbitrary target URLs (and the fetched page contents as applicable) to Bright Data — a privacy/data-exposure consideration.
Install Mechanism
There is no install spec (instruction-only with two included shell scripts). No third-party packages are downloaded or installed by the skill itself, which minimizes installation risk.
Credentials
The skill needs two environment variables (BRIGHTDATA_API_KEY and BRIGHTDATA_UNLOCKER_ZONE) which are appropriate for Bright Data integration, but the registry metadata fails to declare them or a primary credential. The scripts also implicitly require curl and jq to be present on PATH, but the manifest does not list required binaries — another mismatch that could mislead users about prerequisites.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide settings, and has normal autonomous-invocation defaults. No persistent elevated privileges are requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bright-data
  3. After installation, invoke the skill by name or use /bright-data
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Bright Data skill for web scraping and Google search. - Enables scraping of any webpage as markdown, bypassing bot detection and CAPTCHA. - Supports Google search with structured JSON results. - Requires configuration with BRIGHTDATA_API_KEY and BRIGHTDATA_UNLOCKER_ZONE. - Provides shell scripts for both search and scrape functionalities.
Metadata
Slug bright-data
Version 1.0.0
License
All-time Installs 15
Active Installs 14
Total Versions 1
Frequently Asked Questions

What is Bright Data?

Web scraping and search via Bright Data API. Requires BRIGHTDATA_API_KEY and BRIGHTDATA_UNLOCKER_ZONE. Use for scraping any webpage as markdown (bypassing bot detection/CAPTCHA) or searching Google with structured results. It is an AI Agent Skill for Claude Code / OpenClaw, with 2879 downloads so far.

How do I install Bright Data?

Run "/install bright-data" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Bright Data free?

Yes, Bright Data is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Bright Data support?

Bright Data is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Bright Data?

It is built and maintained by MeirKaD (@meirkad); the current version is v1.0.0.

💬 Comments