跳到主要内容

Capzy Browser API. 连接并自动化。

通过 Chrome DevTools Protocol 在 Capzy 基础设施上运行浏览器自动化。保留 Playwright 或 Puppeteer 工作流,使用远程会话、可选代理和持久化配置。

你的脚本 → Capzy 浏览器CDP / WebSocket
你的应用chromium.connect_over_cdp(CDP_URL)
远程浏览器会话page.goto("https://example.com")
读取页面、交互、收集结果page.title() → "Example Domain"

从连接地址到第一个页面

安装客户端,复制你的 CDP URL,然后连接。身份验证使用 URL 中的 Browser API 用户名和密码。

  1. 激活 Browser API 套餐

    选择满足你业务所需并发会话数、持久化配置数和内含流量的套餐。

    打开 Browser API
  2. 复制连接 URL

    在“总览”中复制包含你 Browser API 用户名和密码的 CDP URL。将其保存为 CAPZY_CDP_URL。它与求解器 API 密钥不同。

  3. 连接、执行任务,然后关闭

    使用 connect_over_cdp 或 puppeteer.connect。在提供的上下文中创建页面,并在 finally 块中关闭浏览器以释放会话。

remote_browser.py
# Install: pip install playwright
import os
from playwright.sync_api import sync_playwright

# Copy your full authenticated URL from Dashboard > Browser API.
# Shape: wss://USERNAME:[email protected]/cdp
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(os.environ["CAPZY_CDP_URL"])
    try:
        page = browser.contexts[0].new_page()
        page.goto("https://example.com", wait_until="domcontentloaded")
        print(page.title())
    finally:
        browser.close()

为每个工作流配置连接

向已鉴权的 CDP URL 添加查询参数。当下次连接需要恢复同一身份时,请保持固定的配置名称。

username:password必填 · URL 凭据
使用从控制台复制的完整 URL。如果自行构建,请对用户名和密码中的保留字符进行百分号编码。
profile=my-identity可选 · 持久化
复用配置名称,即可在会话之间保留支持的浏览器状态。配置会计入你套餐的配置额度。
proxy=capzy-US可选 · 美国代理
通过内置代理选项选择受支持的国家/地区。使用 proxy=capzy 自动选择位置,不需要代理时使用 proxy=none。
带认证的 CDP 连接
wss://USERNAME:[email protected]/cdp?profile=my-identity&proxy=capzy-US
在“控制台 → Browser API → 总览”中获取完整的连接 URL。请妥善保密。

价格

套餐分别包含同时运行的浏览器会话数、已保存的配置数和内含流量。自定义构建器使用当前的公开价格。

正在加载最新价格…

正在加载最新价格…

常见问题

Browser API 还是 Capium Browser?

Browser API 将浏览器托管在 Capzy 基础设施上,并开放 CDP。Capium Browser 是一个在你自己机器上启动浏览器的 SDK。需要远程算力时,请选择 Browser API。

为什么我的 CDP 连接失败?

确认你的套餐有效、用户名和密码与控制台一致,并且你的应用可以访问安全 WebSocket。并发会话额度用尽也会导致无法建立新连接。

我需要 Selenium 吗?

此处的示例使用 Playwright 和 Puppeteer。Selenium 需要进行相应的 CDP 连接设置;请按照 Browser API 连接指南操作,而不是将 WebSocket URL 传给 webdriver.Remote。

让下一个浏览器在这里运行。

选择容量、复制连接地址,并运行上面的示例。

打开控制台