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

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

npm install playwright
npx playwright install chromium --with-deps