# browserbase
> Browse the web, deploy automations, and manage browser sessions from the terminal

## Summary
Official Browserbase CLI — manage cloud browser sessions, deploy serverless automations, fetch pages, search the web, and debug sessions from the terminal.

## Capabilities
- Browse the web via remote cloud browsers
- Deploy serverless browser automation functions
- Fetch page content without opening a browser
- Web search returning structured results
- Manage browser sessions with anti-bot stealth and CAPTCHA solving
- Residential proxies across 201 countries
- Session persistence with context management (cookies, localStorage)
- Upload and manage custom browser extensions
- JSON output for programmatic use

## When to Use
- You need cloud browser sessions for web automation
- You want to deploy serverless browser functions
- You need to fetch or scrape pages with bot protection bypass
- You need web search results from the terminal

## When NOT to Use
- You don't have a Browserbase account or API key
- You only need simple HTTP requests (use curl)

## Key Flags
- `fetch <url>`: Retrieve page content without opening a browser
- `search <query>`: Execute web searches with structured results
- `sessions list`: List and manage browser sessions
- `functions deploy`: Deploy a serverless browser function
- `dashboard`: Open the Browserbase console

## Usage Patterns
### Fetch a page
```
bb fetch https://example.com
```
Retrieve page content as text

### Search the web
```
bb search "best CLI tools" --json
```
Web search with JSON output

### Deploy a function
```
bb functions deploy
```
Deploy a serverless browser automation to the cloud

### List sessions
```
bb sessions list
```
View active and recent browser sessions

## Input / Output
- **stdout**: Page content, search results, session data, JSON output

## Installation
- **npm**: `npm install -g @browserbasehq/cli`

## Related Tools
- [firecrawl-cli](/tools/firecrawl-cli) (complementary): Web scraping and crawling focused on LLM-ready content

---
Source: https://littlescripts.sh/tools/browserbase-cli