---
title: "Meet the Bright Data CLI: Extract Data and Interact with the Web from Your Terminal"
slug: bright-data-cli
date: 2026-04-27T15:32:12+00:00
modified: 2026-04-27T15:32:16+00:00
permalink: https://brightdata.de/blog/ai/bright-data-cli
type: blog
---

[ Blog ](https://brightdata.de/blog "Blog") / [AI](https://brightdata.de/blog/ai)







 [AI](https://brightdata.de/blog/ai)

# Meet the Bright Data CLI: Extract Data and Interact with the Web from Your Terminal

The Bright Data CLI lets you scrape, search, and extract web data from your terminal with just a few simple commands.

 16 min lesen





 [ ![Meir Kadosh](https://media.brightdata.de/2025/08/Meir-Kadosh-50x50.jpg) ](https://brightdata.com/blog/authors/meir-kadosh)

 [Meir Kadosh

AI Engineer

 ](https://brightdata.com/blog/authors/meir-kadosh)





 ![Bright Data CLI blog iamge](https://media.brightdata.de/2026/04/Bright-Data-CLI-blog-iamge.png)





In this guide, you will discover:

- What the Bright Data CLI is, how it works, the features it offers, and the commands it exposes.
- How to install and get started with it on Linux, macOS, WSL, and Windows.
- How to take the first steps with the CLI in a simple, guided way.
- The use cases and scenarios it supports, demonstrated with real-world examples.

Let’s dive in!

## An Introduction to the Bright Data CLI

Before seeing it in action, understand what the Bright Data CLI brings to the table and how it works.

### What Is the Bright Data CLI?

The [Bright Data CLI](https://github.com/brightdata/cli) is an all-in-one terminal tool that provides streamlined access to the full Bright Data API surface. In other words, it simplifies integration with [Bright Data products and services](/products) by exposing direct terminal commands to use, control, and integrate them.

At a high level, it provides commands to:

- Scrape any website while bypassing CAPTCHAs and anti-bot protections via the [Web Unlocker API](/products/web-unlocker).
- Perform structured searches across major engines like Google, Bing, Yandex, and others using the [SERP API](/products/serp-api).
- Extract data from 40+ platforms (e.g., Amazon, LinkedIn, Instagram) through [Web Scraping APIs](/products/web-scraper).
- Programmatically interact with web pages using an unblockable remote browser via the [Browser API](/products/scraping-browser).
- Simplify setup and orchestration with [Bright Data MCP](/ai/mcp-server).
- [And much more…](https://docs.brightdata.com/cli/overview#what-can-you-do-with-the-cli)

### Further reading:

- [Bright Data CLI documentation](https://docs.brightdata.com/cli/overview)
- [Official GitHub page](https://github.com/brightdata/cli)
- [`@brightdata/cli` npm package](https://www.npmjs.com/package/@brightdata/cli)

### How It Works

[`@brightdata/cli`](https://www.npmjs.com/package/@brightdata/cli) is the official npm package for the Bright Data CLI. Once installed, it gives you access to the `brightdata` command (with `bdata` as a shorthand), allowing you to interact with the full Bright Data API surface directly from your terminal.

The `brightdata` CLI tool wraps the entire Bright Data web data platform, exposing it via simple, developer-friendly commands. Under the hood, it:

1. [Authenticates once via OAuth, device flow, or API key](https://docs.brightdata.com/api-reference/authentication), storing credentials locally so you do not need to re-enter them. After that, every command works out of the box—no need to manage tokens, create zones, or configure proxies!
2. Automatically provisions the required zones in your Bright Data account (`cli_unlocker` and `cli_browser`) on first login so you can start immediately.
3. Routes requests through Bright Data’s infrastructure, handling CAPTCHAs, bot detection, IP rotation, JavaScript rendering, and all other [web scraping challenges](/blog/web-data/web-scraping-challenges).
4. Returns clean, usable output, including formatted tables in the terminal or structured JSON, CSV, or Markdown (great data formats for downstream analysis and processing, [including AI workflows](https://www.kaggle.com/code/brightdataml/benchmarking-ai-on-different-data-formats)).

### Features and Capabilities

Below is a list of the core features provided by the Bright Data CLI:

- **Infrastructure and cost management**: Monitor proxy usage, inspect configurations, and track account balance, bandwidth, and per-zone costs from a single CLI-based interface.
- **Universal web scraping**: Access data from any website with built-in handling of anti-bot protections, delivering clean, ready-to-use outputs.
- **Search engine data access**: Run queries across major search engines and receive structured results, including organic listings, ads, and more.
- **Structured data extraction**: Pull web data feeds from dozens of platforms, ready for analysis.
- **Remote browser automation**: Interact programmatically with live web pages through a managed browser, performing navigation, clicks, typing, and handling dynamic content.
- **Automation-friendly workflows**: Integrate commands into Bash scripts and pipelines, supporting chaining and large-scale data processing.
- **AI agent integration**: Add prebuilt skills or MCP connections to AI coding assistants in a simplified way.
- **Easy setup and configuration**: Quickly initialize the CLI and manage environment settings with guided setup and centralized configuration for credentials and defaults.

### Main Commands

The Bright Data CLI is available via the `brightdata` command (or the `bdata` alias). You can use it like this:

```none
brightdata <COMMAND> <ARGUMENTS>
```

The supported commands are:

**Command****What it does**[`scrape <url>`](https://docs.brightdata.com/cli/commands#brightdata-scrape-%3Curl%3E)Scrape any website while handling CAPTCHAs, JavaScript rendering, and other anti-scraping protections.[`search <query>`](https://docs.brightdata.com/cli/commands#brightdata-search-%3Cquery%3E)Run structured searches on Google, Bing, or Yandex and receive organized JSON results.[`pipelines <type> [params...] [options]`](https://docs.brightdata.com/cli/commands#brightdata-pipelines-%3Ctype%3E-params--options)Extract structured data from over 40 platforms, such as Amazon, LinkedIn, TikTok, and more.[`browser`](https://github.com/brightdata/cli?tab=readme-ov-file#browser)Control a real browser remotely to navigate, click, type, and interact with web pages programmatically.[`add mcp`](https://github.com/brightdata/cli?tab=readme-ov-file#add-mcp)Connect the Bright Data MCP server to AI coding agents like Claude Code, Cursor, or Codex.[`skill`](https://docs.brightdata.com/cli/commands#brightdata-skill)Install prebuilt Bright Data AI agent skills into coding assistants for enhanced automation.[`zones`](https://docs.brightdata.com/cli/commands#brightdata-zones)List and inspect your Bright Data proxy zones and their current configurations.[`budget`](https://docs.brightdata.com/cli/commands#brightdata-budget)View your account balance, per-zone costs, and bandwidth usage at a glance.For a complete list of commands, along with their supported options and arguments, [refer to the docs](https://docs.brightdata.com/cli/commands).

## Getting Started with the Bright Data CLI: Step-by-Step Guide

In the following tutorial sections, you will be guided through the process of setting up the Bright Data CLI on your local machine.

The installation procedure depends on your environment:

- On Linux or macOS, you can rely on a dedicated CLI installer to get started quickly.
- On Windows, or on Linux/macOS using Node.js, you need to install the npm package globally and complete the configuration with a specific command.

In both cases, the initial setup takes only a few minutes!

The next two chapters will present both approaches, starting with the common prerequisites.

### Prerequisites

To operate the Bright Data CLI on your machine (regardless of the environment), you need:

- [Node.js version 20+](https://nodejs.org/en/download) installed locally (LTS version recommended).
- A [Bright Data](/) account (you can [create a new one for free](/?hs_signup=1)).

## Setting Up the Bright Data CLI on Linux/macOS/WSL

On macOS, Linux, and other Unix-based systems (including WSL), install the Bright Data CLI with:

```none
curl -fsSL https://cli.brightdata.com/install.sh | sh
```

This command downloads the Bright Data CLI installer and runs it. This will install *and set up* the CLI.

This is the output you should get:
![The Bright Data CLI installer](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774949556848_image.png)

Notice that the `@brightdata/cli` npm package has been installed globally. Then, a URL will be shown to authenticate with your Bright Data account. A browser page should open automatically to the Bright Data login page. If it does not, copy the URL and open it manually.

After logging in, you should see the following confirmation:
![The Bright Data authentication success page](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774948749052_image.png)

If the authentication succeeds, the Bright Data CLI will create the required zones and be fully operational on your system:
![The required zones have been set up](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774949734121_image.png)

Check that the setup completed successfully with:

```none
brightdata --version
```

Or the equivalent alias:

```none
bdata --version
```

In both cases, the result should look something like this:

```none
0.1.5
```

In this case, `0.1.5` is the version of the Bright Data CLI installed locally.

The Bright Data CLI is installed locally, your Bright Data account is configured, and the CLI is authenticated. Mission complete!

## Setting Up the Bright Data CLI on Windows or Any Other OS via Node.js

Follow the steps below to get started with the Bright Data CLI on Windows, or manually on any other operating system via Node.js.

### Step #1: Install the CLI via npm

On Windows or any platform, [install the Bright Data CLI globally using npm](https://docs.brightdata.com/cli/installation):

```none
npm install -g @brightdata/cli
```

This sets up the `brightdata` command so it can be used from anywhere on your machine.

**Note**: You can also run the CLI without installing it via:

```none
npx --yes --package @brightdata/cli brightdata <command>
```

Check that the `brightdata` command (or its alias `bdata`) is available globally with:

```none
brightdata --version
```

The result will show the installed package version, like:

```none
0.1.5
```

Great! The Bright Data CLI is now installed locally and accessible as a global command.

### Step #2: Connect to Your Bright Data Account

Run the following command to [link the CLI with your Bright Data account](https://docs.brightdata.com/cli/installation#authenticate):

```none
brightdata login
```

You should see this output:
![The output of the login command](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774950725198_image.png)

A browser page will open automatically to the Bright Data login page. If it does not, copy the provided URL and open it manually. This allows you to authenticate via OAuth with your Bright Data account.

After logging in, you should see a confirmation page like this:
![The Bright Data authentication success page](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774948749052_image.png)

A new Bright Data Agent API key is created and stored locally on your machine for authentication. Once successful, the CLI automatically sets up the required zones and is ready to use:
![The required zones have been set up](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774950846423_image.png)
In summary, the `login` command:

1. Validates and stores your API key locally
2. Automatically creates required proxy zones (`cli_unlocker`, `cli_browser`)
3. Configures sensible defaults so you can start immediately

**Note**: To log out and reset authentication, run:

```none
brightdata logout
```

Excellent! The Bright Data CLI is now installed, authenticated, and ready for use.

## Post-Setup Overview and First Steps (Optional)

After setting up the Bright Data CLI, your Bright Data account will now include two new zones ( `cli_unlocker` and `cli_browser`):
![Ntoe the two new zones added by the CLI](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774951383100_image.png)

You will also have a new Agent API key, a special Bright Data API key created via OAuth that can manage the zones, send requests, retrieve budget information, and more:
![Note the new Agent API key](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774951623560_image.png)

If this is your first time running the CLI, [get started with the `init` command](https://docs.brightdata.com/cli/installation#interactive-setup-wizard):

```none
brightdata init
```

This launches an interactive wizard to configure the Bright Data CLI and provides some examples for testing.

During the setup, you will be asked to:

- Confirm the configured Bright Data Agent API key or update it.
- Select the default Web Unlocker zone (default: `cli_unlocker`).
- Choose whether to use the same zone as the default for the SERP API.
- Select a default output format (Markdown or JSON).

Once completed, you will see a concise setup summary followed by example Bright Data CLI commands to test and verify the installation.
![The output of the “brightdata init” command](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774952277060_image.png)

**Note**: To view the current configuration, use the [`brightdata config`](https://docs.brightdata.com/cli/commands#brightdata-config) command. To update a setting, run:

```none
brightdata config set <CONFIG_NAME> <CONFIG_VALUE>
```

Otherwise, [override them using global environment variables](https://docs.brightdata.com/cli/examples#environment-variables).

## Bright Data CLI in Action: Real-World Examples

The Bright Data CLI supports several commands, each with many options. Here, we will explore some of the most relevant ones. For a complete list of examples, [explore the documentation](https://docs.brightdata.com/cli/examples).

**Note**: The use of the Bright Data CLI is free for up to 5,000 requests per month on a recurring basis. So, you can get started for free!

### Scraping Any Website

To retrieve content from a web page, use the `scrape` command like this:

```none
brightdata scrape https://nodejs.org/en
```

The result is output to STDOUT in Markdown format (the default data format):
![Note the Markdown resulr produced by the script](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774958576260_1.gif)

That corresponds to the Markdown version ([ideal for LLM ingestion](https://www.kaggle.com/code/brightdataml/benchmarking-ai-agents-on-different-data-formats)) of the page specified in the command:
![The target page](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774958651577_image.png)

If you instead want to geolocalize the request in a specific country (e.g., the US), use the `--country` argument:

```none
brightdata scrape amazon.com/Apple-Cellular-Multisport-Smartwatch-Titanium/dp/B0FQF9TJ86 --country us
```

You will get the result as if you were navigating the page from the US (useful for bypassing geo-restrictions or viewing content that changes based on location).

To export the result to a file, use the `-o` argument:

```none
brightdata scrape https://www.w3schools.com/sql/sql_where.asp -o tutorial.md
```

A `tutorial.md` file will be created and populated with the scraped content in Markdown format:
![The “tutorial.md” file](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774958951764_image.png)

To get the raw HTML, specify the format using the `-f` argument. Also, consider writing the output to a file:

```none
brightdata scrape https://developer.mozilla.org/en-US/ -f html -o index.html
```

The output will be a file named `index.html` containing the raw HTML of the scraped page:
![The “index.html” file](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774958975498_image.png)

With a similar mechanism, you can also take a screenshot of a given page:

```none
brightdata scrape https://www.amazon.com/Apple-2026-MacBook-13-inch-Laptop/dp/B0GR6BVYS5?th=1 -f screenshot -o page.png
```

`page.png` will contain:
![The screenshot taken from the target page](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774959524080_image.png)

### Searching the Web

Perform web searches directly from the CLI using the `search` command:

```none
brightdata search "best chatgpt scrapers"
```

The results are returned as a formatted table, making them easy to read and inspect:
![The resulting table](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774959845303_image.png)

The resulting table corresponds to the Google SERP for the “best cheap scrapers” query:
![The “best cheap scrapers” Google SERP](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774961105955_image.png)

To control the Google results page, specify the `--page` argument:

```none
brightdata search "best llms" --page 2
```

![](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774960859101_image.png)If you need structured data for further processing, get the raw JSON output using the `--json` flag:

```none
brightdata search "node.js security best practices" --json
```

That is perfect for piping results into scripts or integrating with other tools:
![The resulting SERP results in structured JSON](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774959939257_image.png)

For a more readable version of the raw output, set the `--pretty` flag:

```none
brightdata search "best llm scrapers" --pretty
```

The above command produces the results in a nicely formatted way, which is helpful during debugging or exploration:
![Note the indented JSON result](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774960078502_image.png)

You can also customize the search context. For example, to run a localized query in a specific country and language:

```none
brightdata search "mejores restaurantes italianos en Madrid" --country es --language es
```

The command returns results as if the search were performed from Spain, in Spanish:
![Note how the results are in Spanish and specific to Madrid](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774960369985_image.png)

Finally, you can specialize the type of results you want. For instance, to retrieve only news results:

```none
brightdata search "barcelona beaches" --type images
```

Other supported types include `shopping` and `news`, depending on your use case.

### Getting Structured Data Feeds

Beyond raw scraping, you can use the `pipelines` command to extract structured data from popular platforms. This returns clean, ready-to-use datasets for specific applications.

For example, to collect structured details from an Amazon product page, run:

```none
brightdata pipelines amazon_product "https://www.amazon.com/Apple-2025-MacBook-Laptop-10%E2%80%91core/dp/B0FWD726XF/"
```

This will trigger an async task on the [Bright Data Amazon Web Scraper](/products/web-scraper/amazon) and automatically poll it until the response is ready:
![The CLI polls the result](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774961783227_image.png)

Once the target dataset is ready, it will be printed in the terminal (in JSON, the default format):
![The resulting dataset](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774961800219_image.png)
The output includes product title, price, rating, specifications, and more in a structured format.

Similarly, for company-level insights, you can use pipelines targeting [business intelligence sources like Crunchbase](/products/web-scraper/crunchbase):

```none
brightdata pipelines crunchbase_company "https://www.crunchbase.com/organization/brightdata"
```

The above `pipelines` command gathers key details such as funding, industry, and company overview:
![Note the structured company info retrieved from Crunchbase](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774962306123_image.png)

That matches the public information you can find on the Crunchbase company page:
![The target Crunchbase page](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774962087409_image.png)

If you instead want to get structured data from LinkedIn profiles, run:

```none
brightdata pipelines linkedin_person_profile "https://es.linkedin.com/in/antonello-zanini"
```

The returned information includes name, role, experience, and education:
![The output produced by the LinkedIn scraping pipeline](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774962120833_image.png)

As with scraping, you can export structured results to a file:

```none
brightdata pipelines crunchbase_company "https://www.crunchbase.com/organization/brightdata" --format csv -o company.csv
```

This creates a `company.csv` file with structured company data, ready for downstream analysis and processing:
![The “company.csv” output file](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774962339864_image.png)

### Control a Real Browser Session

The `browser` command lets you control a real, remote browser powered by Bright Data’s Scraping Browser API. It maintains a persistent session, so you can interact with pages step by step without reconnecting on every command.

To start a session and navigate to a page, run:

```none
brightdata browser open https://example.com
```

This automatically launches a browser session and loads the target page:

![The output produced by the command](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774965018639_image.png)To read the page content in a structured and token-efficient way, write:

```none
brightdata browser snapshot --compact
```

That returns an accessibility tree of the page, where each interactive element is assigned a reference ID (e.g., `e1`, `e2`) that you can use for further actions:
![The accessibility tree returned by the command](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774965126036_image.png)

Note how the returned tree matches the target webpage:
![The target site (example.com)](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774965178430_image.png)

You can now interact with the page, such as by clicking an element:

```none
brightdata browser click e1
```

Or typing into an input field, take a screenshot, and many other actions.

Finally, when you are done, close the session:

```none
brightdata browser close
```

This stops the remote browser:
![The closed session success message](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774965277952_image.png)

### Chaining Commands with Unix Pipes

The Bright Data CLI is engineered to be pipe-friendly. When STDOUT is not a TTY, colors and spinners are automatically disabled, making it ideal for scripting and automation.

This mechanism helps you can chain commands together to build simple data pipelines. Here is how to go from [searching to scraping](https://hackernoon.com/search-and-extract-why-this-ai-pattern-matters-tutorial-and-example) in one flow:

```none
brightdata search "best python scraping libraries" --json
  | jq -r ".organic[0].link"
  | xargs brightdata scrape
```

The above pipeline performs a Google search, extracts the first result URL (a Reddit page, in this case), and immediately scrapes it (returning its content in Markdown):
![The otutput produced by the pipeline](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774964248022_image.png)

This pattern is especially powerful when integrating Bright Data into shell scripts, cron jobs, or larger data workflows. To run it, you must have `jq` installed locally:

```none
sudo apt-get install jq
```

### Extending Your Coding Agents with Skills

Enhance your AI coding agents by installing the [Bright Data skills](https://github.com/brightdata/skills) directly from the CLI.

To select and install skills interactively, run:

```none
brightdata skill add
```

This opens an interactive picker where you can choose which skills to install and which agentic solution (Claude Code, Amp, Cline, Codex, and others) to target:
![The wizard to configure the skills to intall and where to configure them](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774963615973_image.png)

Alternatively, you can connect Bright Data directly to your agentic solution via the [Bright Data MCP](https://docs.brightdata.com/ai/mcp-server/overview):

```none
brightdata mcp add
```

That links the Bright Data MCP server to Claude Code, Cursor, or Codex, enabling them to access scraping, search, and data pipelines as native tools:
![The wizard to integrate the Bright Data MCP into Claude Code, Cursor, or Codex](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774963596554_image.png)

### Account Management and Monitoring

Harness the CLI to monitor your Bright Data account, keeping track of usage, balance, and costs in real time.

To see all available zones, use:

```none
brightdata zones
```

A possible output is:
![The available zones](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774963141447_image.png)

That matches the “My Zones” table in your Bright Data control panel:
![The “My Zones” table listing all your Bright Data zones](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774963193774_image.png)

To quickly check your remaining balance, run:

```none
brightdata budget
```

This returns a high-level overview of your current credits:
![Note the current balance info](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774962902773_image.png)

If you want to analyze the spending across different zones, inspect the cost distribution with:

```none
brightdata budget zones
```

This shows how your usage is split by zone, making it easier to identify where your credits are being consumed:
![Example of a spending report](https://media.brightdata.com/2026/04/s_380A92F171ABEC99F2329D912A91A30D59AD788073D12E012DB39D44CAC4E7D7_1774962955978_image.png)

## Conclusion

In this blog post, you learned what the Bright Data CLI delivers and the main benefits it provides. You now know it allows you to connect, interact, and operate all [Bright Data API-based solutions](/products) directly from your terminal.

The CLI is fully pipe-friendly, supporting even complex Bash-based data workflows. Discover all supported scenarios, commands, and integrations in the [Bright Data CLI documentation](https://docs.brightdata.com/cli/overview). Also, consider [leaving a star on the GitHub repository!](https://github.com/brightdata/cli)

Create a Bright Data account for free today and try out their web data products—even via the CLI!

## FAQ

For more FAQs and troubleshooting, check the [official documentation](https://docs.brightdata.com/cli/faqs).

### Do I need a Bright Data account to use the CLI?

Yes! The CLI uses Bright Data’s infrastructure to manage web requests. You can [create a free account and begin with the free tier](/?hs_signup=1).

### Where are my Bright Data CLI credentials stored?

Credentials are stored locally on your machine, with permissions set to owner read/write only (`0o600`):

- **macOS**: `~/Library/Application Support/brightdata-cli/credentials.json`
- **Linux**: `~/.config/brightdata-cli/credentials.json`
- **Windows**: `%APPDATA%brightdata-clicredentials.json`

### How do I log in on a remote server without a browser?

Use the `login` command with the `device` option:

```none
brightdata login --device
```

This prints a URL and verification code. Open the URL on any device with a browser, enter the code, and authentication will complete on the server.

### What output formats are supported?

The output data formats supported by the Bright Data CLI are:

- **For the `scrape` command**: `markdown` (default), `html`, `json`, and `screenshot`.
- **For the `search` command**: formatted table (default), `json` (raw JSON), and `pretty` (indented JSON).
- **For the `pipelines` command**: `json` (default), `csv`, `ndjson`, and `jsonl`.
    Keep in mind that all commands support the `-o <path>` option to write the scraped output directly to a file.



Vertrieb kontaktierenGratis testen![google social icon](/wp-content/themes/brightdata/assets/images/ic_google.svg)









 Inhaltsverzeichnis













 [ ](https://news.ycombinator.com/submitlink?t=Meet+the+Bright+Data+CLI%3A+Extract+Data+and+Interact+with+the+Web+from+Your+Terminal&u=https://brightdata.de/blog/ai/bright-data-cli) [ ](https://www.linkedin.com/shareArticle?mini=true&title=Meet+the+Bright+Data+CLI%3A+Extract+Data+and+Interact+with+the+Web+from+Your+Terminal&url=https://brightdata.de/blog/ai/bright-data-cli) [ ](http://www.reddit.com/submit?title=Meet+the+Bright+Data+CLI%3A+Extract+Data+and+Interact+with+the+Web+from+Your+Terminal&url=https://brightdata.de/blog/ai/bright-data-cli)







##  Das könnte Sie auch interessieren

 [ ![OpenHuman with Bright Data](https://media.brightdata.de/2026/09/OpenHuman-with-Bright-Data.png) ](https://brightdata.de/blog/ai/openhuman-with-bright-data "Produktionsreifer Web-Zugriff in OpenHuman über die Bright Data CLI")

 [AI



 ![Antonello Zanini](https://media.brightdata.de/2022/12/Antonello-Zanini-2-50x50.jpg)

Antonello Zanini

Technical Writer





### Produktionsreifer Web-Zugriff in OpenHuman über die Bright Data CLI

Integrieren Sie die Bright Data CLI mit OpenHuman, um produktionsreifen Web-Zugriff und Datenerhebung für KI-Agenten zu ermöglichen.



 09-Sep-2026

 12 min lesen

 ](https://brightdata.de/blog/ai/openhuman-with-bright-data)

 [ ![Multimodal Web Scraping with MiniMax](https://media.brightdata.de/2026/09/Multimodal-Web-Scraping-with-MiniMax.png) ](https://brightdata.de/blog/web-data-de/multimodal-web-scraping-with-minimax "Multimodales Web-Scraping mit MiniMax")

 [Web Data



 ![Antonello Zanini](https://media.brightdata.de/2022/12/Antonello-Zanini-2-50x50.jpg)

Antonello Zanini

Technical Writer





### Multimodales Web-Scraping mit MiniMax

Kombinieren Sie Bright Data Web Unlocker mit MiniMax M3 Vision, um strukturierte Daten aus Bildern und Webseiten-Screenshots zu extrahieren.



 09-Sep-2026

 4 min lesen

 ](https://brightdata.de/blog/web-data-de/multimodal-web-scraping-with-minimax)

 [ ![The 10 Best CLI Tools for Codex in 2026](https://media.brightdata.de/2026/08/The-10-Best-CLI-Tools-for-Codex-in-2026.png) ](https://brightdata.de/blog/ai/best-cli-tools-for-codex "Die 10 besten CLI-Tools für Codex im Jahr 2026 – Getestet & Bewertet")

 [AI



 ![Daniel Shashko](https://media.brightdata.de/2022/04/Daniel-Shashko-2-50x50.png)

Daniel Shashko

Web Data &amp; AI Expert





### Die 10 besten CLI-Tools für Codex im Jahr 2026 – Getestet &amp; Bewertet

Die 10 CLI-Tools, die Codex schneller und leistungsfähiger machen, beginnend mit dem Bright Data CLI für echten Web-Zugriff aus der Sandbox heraus.



 06-Sep-2026

 20 min lesen

 ](https://brightdata.de/blog/ai/best-cli-tools-for-codex)
