创建并连接
用 REST API 创建临时会话,再用 Playwright chromium.connectOverCDP 连接返回的地址。复用返回的浏览器上下文,在其中打开 Quotes to Scrape 的 JavaScript 页面。
01 / 产品介绍
AdsCrawl 远程 CDP 浏览器通过 Chrome DevTools Protocol 提供临时云端 Chromium 会话。REST API 负责创建与删除会话,兼容客户端通过返回的连接地址控制运行中的浏览器。
Playwright 云浏览器:跟随 Node.js 示例,通过 chromium.connectOverCDP 连接 Playwright 并清理会话。
Puppeteer 云浏览器:跟随 Puppeteer 示例发现 WebSocket 地址、连接并释放远程会话。
实际效果
这是连接 AdsCrawl Remote CDP 后的 Playwright 实际运行记录:打开 JavaScript 页面,点击 Next,读取第二页,然后删除会话。
实际采集于
{
"targetUrl": "https://quotes.toscrape.com/js/",
"startedAt": "2026-11-04T05:58:10.916Z",
"client": "Playwright",
"createStatus": 201,
"steps": [
{
"action": "Open JavaScript page",
"url": "https://quotes.toscrape.com/js/",
"title": "Quotes to Scrape",
"quoteCount": 10,
"firstAuthor": "Albert Einstein"
},
{
"action": "Click Next",
"url": "https://quotes.toscrape.com/js/page/2/",
"title": "Quotes to Scrape",
"quoteCount": 10,
"firstAuthor": "Marilyn Monroe"
}
],
"cleanup": {
"method": "DELETE",
"status": 200,
"confirmed": true
},
"completedAt": "2026-11-04T05:58:23.692Z"
}
URL 变为 /js/page/2/,首条作者从 Albert Einstein 变为 Marilyn Monroe。运行最后收到了会话 DELETE 的成功响应。
单次公开页面演示,结果反映采集时的页面状态;目标网站、加载条件和请求设置会影响后续结果。
验证一个完整任务
用 REST API 创建临时会话,再用 Playwright chromium.connectOverCDP 连接返回的地址。复用返回的浏览器上下文,在其中打开 Quotes to Scrape 的 JavaScript 页面。
等待 .quote 渲染,读取 10 条内容;点击 Next 后,等待第二页的 .quote,再检查第一位作者为 Marilyn Monroe。不能仅凭 URL 已变化认定正文就绪。
无论断言通过还是抛出异常,都删除临时会话并检查关闭结果。断开客户端连接不等于服务端会话已停止。
参考记录采集于 2026-11-04,为一次 AdsCrawl 运行;不代表所有站点的成功率、性能或费用。请下载原请求与结果,在你的目标页重新验证。
02 / 适用场景
使用 REST API 创建浏览器,再通过 CDP 操作页面;会话 ID 用于管理,连接地址用于协议访问。
连接 Playwright、Puppeteer 或兼容的 CDP 客户端,并检查所需操作与客户端版本的兼容性。
设置支持的空闲和最大会话超时,跟踪活动会话,并删除已完成任务以释放并发容量。
03 / 快速开始
示例环境:Node.js 与 Playwright(npm install playwright)。 先在服务端设置 ADSCRAWL_API_KEY 环境变量。
完整参数与响应说明 →import { chromium } from "playwright";
const base = "https://api.adscrawl.net";
const headers = {
"x-api-key": process.env.ADSCRAWL_API_KEY,
"content-type": "application/json",
};
const res = await fetch(base + "/cdp/sessions", {
method: "POST", headers,
body: JSON.stringify({ idleTimeoutMs: 600000 }),
});
if (!res.ok) throw new Error("Create session failed: HTTP " + res.status);
const session = await res.json();
if (typeof session.sessionId !== "string" || !session.sessionId) {
throw new Error("Create response is missing sessionId");
}
let browser;
try {
if (typeof session.cdpBaseUrl !== "string" || !session.cdpBaseUrl) {
throw new Error("Create response is missing cdpBaseUrl");
}
browser = await chromium.connectOverCDP(
session.cdpBaseUrl
);
const page = await browser.contexts()[0].newPage();
await page.goto("https://www.adscrawl.net");
const title = await page.title();
// Use title in your application; do not log page content or session URLs.
} finally {
try {
await browser?.close();
} finally {
const stopped = await fetch(
base + "/cdp/sessions/" + encodeURIComponent(session.sessionId),
{ method: "DELETE", headers }
);
if (!stopped.ok) throw new Error("Session cleanup failed: HTTP " + stopped.status);
}
}API Key 仅保存在服务端。遇到 HTTP 402 请检查额度,遇到 429 请降低并发并退避重试。
05 / FAQ
不是。API Key 用于 REST 会话管理,协议连接使用返回的带令牌地址。
选择应用已支持的客户端。Playwright 和 Puppeteer 提供高级页面 API,原始 CDP 则需要自行处理命令和事件。
使用云浏览器 API 的保存配置能力,不应假设临时 CDP 会话在删除或过期后仍会保留。