云端快速入门
在我们的服务器上启动一个 Clearcote 浏览器,并用 Playwright 驱动它。你只需要一个 API 密钥、SDK 和一个额外参数。
免费连接 GitHub 即可免费获得 €5 流量。无需信用卡。
一次性赠送,每个 GitHub 账号限领一次。GitHub 账号须注册满 30 天。
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 示例的完整教程见“托管浏览器”。