跳到正文

云端快速入门

在我们的服务器上启动一个 Clearcote 浏览器,并用 Playwright 驱动它。你只需要一个 API 密钥、SDK 和一个额外参数。

免费连接 GitHub 即可免费获得 €5 流量。无需信用卡。

一次性赠送,每个 GitHub 账号限领一次。GitHub 账号须注册满 30 天。

领取 €5

1. 获取 API 密钥

在“API keys”页面创建一个。密钥以 cc_live_ 开头。请妥善保管:任何持有它的人都能花掉你的余额。把它放进环境变量:

export CLEARCOTE_API_KEY=cc_live_...

会话费用从预付余额中扣除:每 GB 流量 €1.00,含住宅代理。可在控制台的“Hosted browsers”标签页充值。详见“价格与流量”。

2. 添加 clearcote 包

云端模式需要 SDK 0.34.0 或更高版本。

bash
npm i clearcote          # Node 20+
pip install clearcote    # Python 3.8+

3. 在云端启动

传入 cloud=True(Python)或 cloud: true(Node)。你会得到一个普通的 Playwright Browser,它连接的是我们服务器上的浏览器。

from clearcote import launch

browser = launch(cloud=True, fingerprint="acct-1", country="de")
page = browser.contexts[0].new_page()
page.goto("https://example.com")
print(page.title())
browser.close()   # ends the cloud session
此标签页在你的机器上运行。
  • fingerprint 决定设备:同一个种子 (seed) 每次都得到同一台设备。country 决定住宅 IP 的出口国家。
  • 请在 browser.contexts[0] 中打开页面:它带有该会话的配置文件和 Cookie。
  • browser.close() 会结束会话。你只为所用流量付费,不按时间计费。
  • 设置 CLEARCOTE_CLOUD=1 与 cloud=True 效果相同,无需改动代码。

不使用 SDK

任何 CDP 客户端都可以:POST /api/v1/browsers 返回一个一次性的 connectUrl,用 Playwright 的 connectOverCDP 或 Puppeteer 的 connect 连接即可。包含 curl、Node 和 Python 示例的完整教程见“托管浏览器”。

下一步

更新于 2026年11月22日 · SDK 0.70.4 · 浏览器 r63

这个页面有帮助吗?