Browser API 常见问题解答

• Browser API 对以下组合提供完整原生支持：
  • Node.js: Puppeteer (原生), Playwright (原生), Selenium WebDriverJS
  • Python: Playwright for Python, Selenium WebDriver for Python
  • Java: Playwright for Java, Selenium WebDriver for Java
  • C# (.NET): Playwright for .NET, Selenium WebDriver for .NET

• Browser API 也可以通过社区或第三方库集成到其他语言：
  • Java: Puppeteer Java
  • Ruby: Puppeteer-Ruby, playwright-ruby-client, Selenium WebDriver for Ruby
  • Go: chromedp, playwright-go, Selenium WebDriver for Go
• 对于未列出的语言，如果库支持远程 Chrome DevTools Protocol 或 WebDriver，也可以进行集成。

​

我在哪里可以找到 Browser API Debugger？

• 通过控制面板手动启动
• 通过脚本远程启动
  • 通过控制面板
  • 通过代码（远程）

  您可以在 Bright Data 控制面板 内轻松访问 Browser API Debugger。操作步骤如下：

  1. 在控制面板中，进入 我的代理 页面
  2. 点击您的 Browser API 代理
  3. 点击 概览 标签
  4. 在右侧，点击 “Chrome Dev Tools Debugger” 按钮

  调试器与 Chrome Dev Tools 入门

  1

  打开 Browser API 会话

  • 确保您有一个 活动的 Browser API 会话
  • 如果您还不知道如何启动 Browser API 会话，请参阅我们的快速入门指南。

  2

  启动调试器

  • 会话启动后，您可以启动调试器。
  • 在 概览 标签中点击调试器按钮以打开 Browser API Debugger 界面（参见上图 链接）

  3

  连接实时浏览器会话

  • 在调试器界面中，您会看到实时 Browser API 会话列表。
  • 选择您希望调试的会话
  • 点击会话链接或将其复制到浏览器中，这将建立调试器与所选会话之间的连接。

  若要从脚本直接访问和启动调试器会话，需发送 CDP 命令：Page.inspect。

  Puppeteer

  Playwright

  Playwright

  PuppeteerSharp

  Playwright

  // Node.js Puppeteer - 使用 devtools 检查页面  
  const page = await browser.newPage();  
  const client = await page.target().createCDPSession();  
  const {frameTree: {frame}} = await client.send('Page.getFrameTree', {});  
  const {url: inspectUrl} = await client.send('Page.inspect', {  
      frameId: frame.id,  
  });  
  console.log(`Inspect session at ${inspectUrl}`);
  
  利用 Chrome Dev Tools
  • 连接实时会话后，您可以使用 Chrome Dev Tools 的强大功能。
  • 使用 Dev Tools 界面检查 HTML 元素、分析网络请求、调试 JavaScript 代码并监控性能。利用断点、控制台日志和其他调试技术识别和解决代码中的问题。
  

curl -v -u SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD https://brd.superproxy.io:9222/json/protocol

​

如果响应中返回 JSON：

• 您的认证和 Browser API 连接成功，请确认脚本中使用的配置正确。
• 如果仍无法连接 Browser API，请联系支持获取进一步帮助。

​

如果响应中未返回 JSON：

• 检查 Browser API 区域的认证信息，确保 USER 和 PASS 值正确。
• 验证网络配置：确认网络或防火墙未阻止到 https://brd.superproxy.io:9222 的出站连接。
• 如果问题仍然存在，请联系支持获取进一步帮助。

• 使用请求拦截或 CDP 自定义功能阻止不必要的资源，如图片、样式表和广告
• 利用浏览器缓存
• 遵循请求管理最佳实践

• 您在自己的脚本中直接设置代理，使用工具如 Puppeteer、Playwright 或 Selenium。
• 您负责管理所有内容：浏览器设置、会话、扩展、反反爬挑战（CAPTCHA、指纹、请求头等）。
• 提供完全控制和灵活性，但您需自行维护和排查所有复杂问题，包括解封和可扩展性。

• 您将自动化脚本连接到运行在 Bright Data 云端的托管浏览器。
• Bright Data 处理基础设施、扩展、反反爬/解封（CAPTCHA、指纹等）和代理轮换。
• 您只需专注于抓取逻辑。对于复杂互动网站，更易于扩展。
• 如果希望强大抓取而无需维护或构建自己的反反爬解决方案，这是理想选择。

• 对于 Playwright 和 Puppeteer，请使用 WebSocket (wss://) 端点连接，主机为 brd.superproxy.io，端口为 9222。
  • 示例连接 URL： wss://${AUTH}@brd.superproxy.io:9222
• 对于 Selenium，请使用 HTTPS 端点连接，主机为 brd.superproxy.io，端口为 9515。
  • 示例连接 URL： https://${AUTH}@brd.superproxy.io:9515

• 普通代理网络： 您自行启动浏览器/进程，通过 brd.superproxy.io:33335 路由流量，并使用 brd-customer-<CID>-zone-<ZONE>:<PASSWORD> 进行认证。
• Browser API（前称 Scraping Browser）： Bright Data 为您启动托管的云端 Chrome。您 不 启动 puppeteer.launch()，而是连接到远程浏览器：

const puppeteer = require('puppeteer-core');

const AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD';      // 在 Browser API Zone → Overview 中找到
const WS  = `wss://${AUTH}@brd.superproxy.io:9222`; 

(async () => {
    const browser = await puppeteer.connect({browserWSEndpoint: WS});
    const page = await browser.newPage();
    await page.goto('https://example.com', {timeout: 2*60*1000});
    console.log(await page.title());
    await browser.close();
})();