browser-api

# 浏览器 API (Scraping Browser) 参考 ## 目录 - [概述](#概述) - [身份验证](#身份验证) - [连接字符串](#连接字符串) - [支持的框架](#支持的框架) - [会话规则](#会话规则) - [快速入门示例](#快速入门示例) - [自定义 CDP 函数](#自定义-cdp-函数) - [地理位置定位](#地理位置定位) - [带宽优化](#带宽优化) - [验证码处理](#验证码处理) - [调试](#调试) - [高级域名](#高级域名) - [错误代码](#错误代码) - [计费模式](#计费模式) - [最佳实践](#最佳实践) - [反模式](#反模式) --- ## 概述 Bright Data 浏览器 API（也称为 Scraping Browser）是一种托管云浏览器服务。它自动处理代理管理、指纹识别、验证码求解和机器人检测绕过。当您需要完整的浏览器自动化时使用它：点击、滚动、填写表单、执行 JavaScript 或处理单页应用 (SPA)。 **何时使用浏览器 API 与其他 API：** | 需求 | 使用 | |------|-----| | 简单的 HTTP 抓取，无需交互 | Web Unlocker | | Google/Bing 搜索结果 | SERP API | | 从已知平台获取结构化数据 | Web Scraper API | | 点击、滚动、填写表单、运行 JS | **Browser API** | | 拦截页面中的 XHR/fetch 调用 | **Browser API** | | 处理需要浏览器的复杂反爬虫 | **Browser API** | | Puppeteer/Playwright/Selenium 自动化 | **Browser API** | --- ## 身份验证 从控制面板中浏览器 API 区域的**概览选项卡**获取凭据。 - **用户名:** `brd-customer-{CUSTOMER_ID}-zone-{ZONE_NAME}` - **密码:** 您的区域密码 bash export BROWSER_AUTH="brd-customer-CUSTOMER_ID-zone-ZONE_NAME:PASSWORD" --- ## 连接字符串 | 框架 | 连接类型 | 端点 | |-----------|----------------|----------| | Playwright | WebSocket | `wss://${AUTH}@brd.superproxy.io:9222` | | Puppeteer | WebSocket | `wss://${AUTH}@brd.superproxy.io:9222` | | Selenium | HTTPS | `https://${AUTH}@brd.superproxy.io:9515` | 将 `${AUTH}` 替换为 `username:password`。 **关键:** 端口错误会导致 407 错误。Playwright/Puppeteer = 端口 `9222`。Selenium = 端口 `9515`。 --- ## 支持的框架 - **Node.js:** Puppeteer, Playwright, Selenium WebDriver - **Python:** Playwright, Selenium - **C# (.NET):** PuppeteerSharp, Playwright, Selenium - **其他语言:** 任何支持 CDP 或 WebDriver 的语言 (Ruby