跳到主要内容

Capium Browser. 在本地运行。

使用 Python 或 Node.js SDK 在自己的机器上启动 Capium。沿用熟悉的自动化方式,选择可复现身份,并控制同时运行的会话数。

Install Capium
# Python SDK
pip install capiumbrowser

# Or in a JavaScript / TypeScript project
npm install capiumbrowser
Windows、macOS 和 Linux套餐按并发会话数计量

完整产品网站与文档: capiumbrowser.com

三步启动本地浏览器

从 Python 开始。SDK 会在首次启动时下载浏览器二进制文件,因此首次运行时请预留时间并确保网络可访问。

  1. 选择你的许可证

    在控制台中打开 Capium Browser,激活套餐并复制其许可证密钥。该密钥与你的 Capzy API 密钥相互独立。

    获取许可证密钥
  2. 安装 SDK 并设置密钥

    使用 pip 或 npm 安装 capiumbrowser。在启动浏览器的进程所使用的环境中设置 CAPIUM_LICENSE_KEY。

  3. 启动并关闭会话

    launch_context 返回 browser、context 和 page。像往常一样操作页面,然后关闭浏览器以释放会话。

set_license.sh
# macOS / Linux: use the license key from your dashboard.
export CAPIUM_LICENSE_KEY='YOUR_CAPIUM_LICENSE_KEY'

# Then launch your script in this shell.
python first_browser.py
first_browser.py
from capiumbrowser import launch_context

# Set CAPIUM_LICENSE_KEY before running this script.
# The browser binary downloads on first launch.
browser, context, page = launch_context(
    seed=200123,
    humanize=True,
    url="https://example.com",
)
try:
    print(page.title())
finally:
    browser.close()
在控制台中打开 Capium Browser,激活套餐并复制其许可证密钥。该密钥与你的 Capzy API 密钥相互独立。 获取许可证密钥

需要了解的几个设置

从单个脚本扩展到工作节点集群时,请明确管理身份和进程生命周期。

CAPIUM_LICENSE_KEY必填 · 环境变量
设置你在 Capium 控制台中的许可证密钥。通过你的机密配置将其传递给容器和工作进程。
seed可选 · 身份
当某个工作流需要呈现同一台一致的设备时,请复用种子。除种子外,还应保持相同的配置。
humanize可选 · 交互行为
在适合你工作流的场景中启用 SDK 的拟人化输入行为。它不保证目标网站会接受每一个请求。
url可选 · 起始页面
在启动时提供第一个 URL,或使用返回的 page 进行导航。任务结束时,请在 finally 块中关闭浏览器。

价格

按同时运行的浏览器数量选择套餐规模。并发会话数与你每月发出的请求总数是两回事。

正在加载最新价格…

常见问题

Capium 在 Capzy 服务器上运行吗?

Capium SDK 在你安装它的机器上运行浏览器。如果你希望由 Capzy 托管浏览器并通过 CDP 远程连接,请使用 Browser API。

为什么首次启动耗时更长?

SDK 会在首次使用时下载其浏览器二进制文件。请确认你的机器可以访问下载服务,并且该进程有权限写入浏览器缓存。

为什么检测不到我的许可证?

检查 CAPIUM_LICENSE_KEY 是否设置在启动 SDK 的同一个 shell、容器或服务中。同时确认许可证有效,且你还有可用的并发会话。

从一个本地会话开始。

获取许可证密钥,运行 Python 示例,再按任务需求扩展并发量。

打开控制台