Skip to content

Releases: brightdata/cli

v0.1.1

18 Mar 14:01
@meirk-brd meirk-brd
v0.1.1
5d0f3a0

Choose a tag to compare

View all tags
v0.1.1 Latest
Latest

Release Notes - @brightdata/cli v0.1.1

First official release of the Bright Data CLI.

What is it?

A command-line interface for the Bright Data platform. Scrape websites, search the web, and extract structured data from 40+ platforms — directly from your terminal.

npm i -g @brightdata/cli

Two commands are available after install: brightdata and bdata (shorthand).

Commands

Command Description
bdata scrape <url> Scrape any URL — bypasses CAPTCHAs, JS rendering, and anti-bot protections
bdata search <query> Search Google, Bing, or Yandex with structured JSON output
bdata pipelines <type> Extract structured data from 40+ platforms (Amazon, LinkedIn, TikTok, and more)
bdata zones List and inspect your Bright Data proxy zones
bdata budget View account balance and per-zone cost and bandwidth
bdata status <id> Check the status of an async job
bdata config Get or set CLI configuration
bdata init Interactive setup wizard
bdata login Authenticate with Bright Data
bdata logout Clear stored credentials
bdata skill Browse and install AI agent skills
bdata version Display version and environment info

Highlights

Scraping

  • Automatic CAPTCHA solving, JavaScript rendering, and anti-bot bypass
  • Output as markdown, HTML, JSON, or screenshot
  • Geo-targeting by country
  • Async job submission with polling

Web Search (SERP)

  • Google (structured results with organic, ads, knowledge graph, people-also-ask), Bing, and Yandex
  • Search types: web, news, images, shopping
  • Device targeting (desktop/mobile), country, and language localization
  • Pagination support

Structured Data Extraction (Pipelines)

42 dataset types across major platforms:

  • E-commerce — Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara, Google Shopping
  • Professional — LinkedIn (profiles, companies, jobs, posts, people search), Crunchbase, ZoomInfo
  • Social — Instagram, Facebook, TikTok, X (Twitter), YouTube, Reddit
  • Other — Google Maps, Google Play, Apple App Store, Reuters, GitHub, Yahoo Finance, Zillow, Booking.com

Authentication

  • Browser-based OAuth for desktop environments
  • Device flow for headless/SSH sessions
  • Direct API key via flag or BRIGHTDATA_API_KEY env variable
  • Automatic zone provisioning on first login

AI Agent Skills

Install Bright Data capabilities into 45+ coding agents (Claude Code, Cursor, Windsurf, GitHub Copilot, and more):

  • search — structured Google search results
  • scrape — webpage scraping as clean markdown
  • data-feeds — structured data extraction from 40+ platforms
  • bright-data-mcp — 60+ MCP tools for search, scraping, and browser automation
  • bright-data-best-practices — reference knowledge base for writing Bright Data code

Output

  • Human-readable tables and markdown in TTY
  • JSON, pretty JSON, CSV, NDJSON for programmatic use
  • File output with auto-format detection (-o results.json)
  • Pipe-friendly — colors and spinners disabled automatically in non-TTY

Configuration

  • XDG-compliant config storage
  • CLI flags > environment variables > config file > defaults
  • Configurable default zones, output format, and API URL

Requirements

Install

# npm
npm i -g @brightdata/cli

# or one-liner
curl -fsSL https://raw.githubusercontent.com/brightdata/cli/main/install.sh | sh

Links

Assets 2
Loading