brightdata-cli
Guide for using the Bright Data CLI (`brightdata` / `bdata`) to scrape websites, search the web, extract structured data from 40+ platforms, manage proxy zones, and check account budget. Use this skill whenever the user wants to scrape a URL, search Google/Bing/Yandex, extract data from Amazon/LinkedIn/Instagram/TikTok/YouTube/Reddit or any other platform, check their Bright Data balance or zones, or do anything involving web data collection from the terminal. Also trigger when the user mentions
Security Assessment
Detected risks:
About brightdata-cli
The Bright Data CLI is a command-line tool that provides direct terminal access to Bright Data's web data platform. It eliminates the complexity of web scraping by automatically handling authentication, proxy management, anti-bot bypass, CAPTCHA solving, and JavaScript rendering. Users simply log in once via OAuth, and the CLI handles all subsequent operations seamlessly without manual configuration or API key management.
This skill enables scraping any URL in multiple formats (markdown, HTML, JSON, screenshot), performing web searches across Google, Bing, and Yandex with structured results, and extracting data from over 40 platforms including Amazon, LinkedIn, Instagram, TikTok, YouTube, and Reddit. The CLI supports both synchronous and asynchronous operations, geo-targeted scraping from specific countries, and provides account management features like budget checking and proxy zone configuration. All operations work through simple commands like 'bdata scrape' or 'bdata search'.
The tool is designed for developers, data analysts, and researchers who need reliable web data collection without infrastructure overhead. Whether gathering competitive intelligence, monitoring content, performing SEO analysis, or collecting training data, the Bright Data CLI handles the technical complexities while exposing a straightforward command interface. It works across macOS, Linux, and Windows, requires only Node.js 20+, and can even run without installation via npx for one-off tasks.
FAQ
How do I authenticate with the Bright Data CLI?
Run 'bdata login' once to authenticate via OAuth in your browser. This saves your credentials locally and auto-configures required proxy zones. For headless environments, use 'bdata login --device' or 'bdata login --api-key <key>' for non-interactive authentication.
What platforms can I extract data from?
The CLI supports structured data extraction from 40+ platforms through pipelines, including Amazon, LinkedIn, Instagram, TikTok, YouTube, Reddit, and many others. Use 'bdata pipelines list' to see all available platform types.
What output formats are supported for scraping?
Scraping supports multiple formats: markdown (default), HTML, JSON for structured data, and screenshot images. Specify format with the -f flag like 'bdata scrape <url> -f html' or 'bdata scrape <url> -f screenshot -o image.png'.
Do I need to manage proxies or handle CAPTCHAs myself?
No. The CLI automatically handles proxy management, anti-bot bypass, CAPTCHA solving, and JavaScript rendering. After the initial 'bdata login', all technical complexity is abstracted away.
Can I scrape from specific geographic locations?
Yes. Use the --country flag to specify geo-targeted scraping, for example 'bdata scrape https://amazon.com --country us' to scrape from a US IP address.
Install brightdata-cli
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
brightdata/skills