5 分钟快速入门：运行您的第一个浏览器会话

本指南帮助您使用 Bright Data 浏览器 API 在 5 分钟内启动您的第一个真实浏览器会话。
它面向需要 JavaScript 渲染、页面交互或动态内容，而不需要管理浏览器或基础设施的开发者。完成本指南后，您将能够：

验证您的浏览器 API 设置
启动一个实时浏览器会话
加载需要 JavaScript 渲染的网站

开始前需要的内容（1 分钟）

在开始之前，请确保您拥有：

一个 Bright Data 账户
一个活跃的浏览器 API 区域
有效的浏览器 API 区域****凭证（用户名和密码）

您可以在 Bright Data 控制面板中浏览器 API 的概览选项卡中找到您的凭证。如果您还没有创建浏览器 API，请先按照创建您的第一个浏览器 API 进行操作。

第 1 步：选择一个基于 JavaScript 的网站（30 秒）

选择一个需要 JavaScript 渲染的网站。好的示例：

确保 URL：

以 https:// 开头
需要客户端渲染或类似用户的交互

第 2 步：了解浏览器 API 如何工作（30 秒）

浏览器 API 会代表您启动一个真实的、基于云的浏览器会话。对于每个会话，Bright Data 会：

启动浏览器实例
应用逼真的指纹和请求头
处理代理路由和反机器人挑战
返回渲染的页面内容或会话输出

您无需管理浏览器、驱动程序或自动化基础设施。

第 3 步：启动您的第一个浏览器 API 会话（2 分钟）

将下面的占位符替换为您的实际值：

USER:PASS
YOUR_TARGET_URL

复制下面的示例代码片段之一，粘贴到您选择的 IDE 中。
只需在替换参数后运行代码即可启动您的会话！

NodeJS
Python

#!/usr/bin/env node
const puppeteer = require('puppeteer-core');

const AUTH = 'USER:PASS';
const TARGET_URL = 'YOUR_TARGET_URL';

async function main() {
    console.log('Connecting to Browser...');
    const browser = await puppeteer.connect({
        browserWSEndpoint: `wss://${AUTH}@brd.superproxy.io:9222`
    });

    const page = await browser.newPage();

    // Get debugging URL
    const client = await page.createCDPSession();
    const { frameTree: { frame } } = await client.send('Page.getFrameTree');
    const { url: inspectUrl } = await client.send('Page.inspect', {
        frameId: frame.id
    });
    console.log(`You can inspect this session at: ${inspectUrl}`);

    // Navigate to target
    await page.goto(TARGET_URL);

	console.log(await page.content());
    await page.screenshot({ path: 'screenshot.png', fullPage: true });
    console.log('Navigation complete!');

    await browser.close();
}

main().catch(console.error);

#!/usr/bin/env node
const playwright = require('playwright');

const AUTH = 'USER:PASS';
const TARGET_URL = 'YOUR_TARGET_URL';

async function main() {
    console.log('Connecting to Browser...');
    const browser = await playwright.chromium.connectOverCDP(
        `wss://${AUTH}@brd.superproxy.io:9222`
    );

    const page = await browser.newPage();

    // Get debugging URL
    const client = await page.context().newCDPSession(page);
    const { frameTree: { frame } } = await client.send('Page.getFrameTree');
        const { url: inspectUrl } = await client.send('Page.inspect', {
            frameId: frame.id,
        });
    console.log(`You can inspect this session at: ${inspectUrl}.`);

    // Navigate to target
    await page.goto(TARGET_URL);

	console.log(await page.content());
    await page.screenshot({ path: 'screenshot.png', fullPage: true });
    console.log('Navigation complete!');
    
    await browser.close();
}

main().catch(console.error);

#!/usr/bin/env python3
import asyncio
from playwright.async_api import async_playwright

AUTH = 'USER:PASS'
TARGET_URL = 'YOUR_TARGET_URL'

async def main():
    print('Connecting to Browser...')
    
    async with async_playwright() as p:
        browser = await p.chromium.connect_over_cdp(
            f'wss://{AUTH}@brd.superproxy.io:9222'
        )
        page = await browser.new_page()
        
        # Get debugging URL
        client = await page.context.new_cdp_session(page)
        frame_tree = await client.send('Page.getFrameTree')
        frame_id = frame_tree['frameTree']['frame']['id']
        inspect_result = await client.send('Page.inspect', {'frameId': frame_id})
        print(f"Debug URL: {inspect_result['url']}")
        
        # Navigate to target
        await page.goto(TARGET_URL)

		print(await page.content())
        await page.screenshot(path='screenshot.png', full_page=True)
        print('Navigation complete!')
        
        await browser.close()

if __name__ == '__main__':
    try:
        asyncio.run(main())
    except Exception as e:
        print(f'Error: {e}')

#!/usr/bin/env python3
from selenium.webdriver import Remote, ChromeOptions as Options
from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection

AUTH = 'USER:PASS'
TARGET_URL = 'YOUR_TARGET_URL'

def main():
    print('Connecting to Browser...')
    
    server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
    connection = Connection(server_addr, 'goog', 'chrome')
    driver = Remote(connection, options=Options())
    
    def cdp(cmd, params={}):
        return driver.execute('executeCdpCommand', {
            'cmd': cmd,
            'params': params,
        })['value']
    
    try:
        # Get debugging URL
        frame_tree = cdp('Page.getFrameTree')
        frame_id = frame_tree['frameTree']['frame']['id']
        inspect_result = cdp('Page.inspect', {'frameId': frame_id})
        print(f"Debug URL: {inspect_result['url']}")
        
        # Navigate to target
        driver.get(TARGET_URL)

		print(driver.page_source)
        driver.save_screenshot('screenshot.png')
        print('Navigation complete!')
    finally:
        driver.quit()

if __name__ == '__main__':
    try:
        main()
    except Exception as e:
        print(f'Error: {e}')

此代码：

连接到远程浏览器会话
打印实时会话 URL
使用 JavaScript 完全渲染页面
打印页面的 HTML 内容
拍摄渲染页面的屏幕截图
关闭浏览器会话

第 4 步：查看响应（30 秒）

如果成功，您将收到：

完全渲染的 HTML 内容 + 屏幕截图
包含 JavaScript 生成的元素

如果页面内容与您在真实浏览器中看到的内容匹配，则您的浏览器 API 设置工作正常。

常见问题和快速修复（30 秒）

407 认证失败： 认证缺失或无效
→ 验证用户名和密码凭证
无效的 URL： 所需的 URL 格式不正确
→ 确认 TARGET_URL 参数已更改为有效的 URL

您刚刚完成的任务

在 5 分钟内，您：

连接到远程无头浏览器会话
加载了一个 JavaScript 繁重的网站
检索了渲染的内容

您的浏览器 API 现在已准备好用于高级工作流程。

下一步

一旦您的第一个会话工作正常，您可以：

与页面交互（点击、滚动、输入）
运行多步浏览器工作流程
查看浏览器 API 配置了解高级控制
检查故障排除如果您遇到问题

快速开始

数据提取

Web 访问

AI 训练数据

代理网络

5 分钟快速入门：运行您的第一个浏览器会话

开始前需要的内容（1 分钟）

第 1 步：选择一个基于 JavaScript 的网站（30 秒）

第 2 步：了解浏览器 API 如何工作（30 秒）

第 3 步：启动您的第一个浏览器 API 会话（2 分钟）

第 4 步：查看响应（30 秒）

常见问题和快速修复（30 秒）

您刚刚完成的任务

下一步

​开始前需要的内容（1 分钟）

​第 1 步：选择一个基于 JavaScript 的网站（30 秒）

​第 2 步：了解浏览器 API 如何工作（30 秒）

​第 3 步：启动您的第一个浏览器 API 会话（2 分钟）

​第 4 步：查看响应（30 秒）

​常见问题和快速修复（30 秒）

​您刚刚完成的任务

​下一步

开始前需要的内容（1 分钟）

第 1 步：选择一个基于 JavaScript 的网站（30 秒）

第 2 步：了解浏览器 API 如何工作（30 秒）

第 3 步：启动您的第一个浏览器 API 会话（2 分钟）

第 4 步：查看响应（30 秒）

常见问题和快速修复（30 秒）

您刚刚完成的任务

下一步