.agents/skills/human-browser/references/brightdata-setup.md

58 lines
1.5 KiB
Markdown

# Bright Data — Setup & Reference
## Sign Up
- Registration: https://brightdata.com/
- After signup, go to: https://brightdata.com/cp/zones
## Create Zones
### Web Unlocker Zone (for regular proxying)
1. Dashboard → Proxies & Scraping → Add Zone
2. Type: **Web Unlocker**
3. Name: `mcp_unlocker` (or any name)
4. Country: Romania (or leave "All" for auto-rotation)
5. Copy credentials from zone settings
### Scraping Browser Zone (for Playwright CDP)
1. Dashboard → Proxies & Scraping → Add Zone
2. Type: **Scraping Browser**
3. Name: `mcp_browser`
4. Used for: `wss://brd.superproxy.io:9222` CDP endpoint
## Billing & Top-Up
- Top up balance: https://brightdata.com/cp/billing
- Minimum deposit: $10
- Pay-as-you-go pricing:
- Web Unlocker: ~$3/GB
- Scraping Browser: ~$9/hour
## Proxy Credentials Format
```
# HTTP Proxy (for Playwright context)
server: http://brd.superproxy.io:22225
username: brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>-country-ro
password: <ZONE_PASSWORD>
# CDP WebSocket (Scraping Browser only)
wss://brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>-country-ro:<PASSWORD>@brd.superproxy.io:9222
```
## Where to Find Credentials
- Dashboard: https://brightdata.com/cp/zones
- Click on your zone → **Access Parameters** tab
- Copy: Customer ID, Zone name, Password
## Country Codes
- `ro` — Romania (DIGI / WS Telecom residential IPs)
- `us` — United States
- `de` — Germany
- Remove `-country-XX` for global rotation
## Node.js Dependency
```bash
npm install playwright
npx playwright install chromium --with-deps
```