跳转到主要内容

远程 CDP 浏览器

远程 CDP 浏览器,管理临时 Chromium 会话。

创建云端 Chromium 并连接 CDP 客户端,明确管理浏览器创建、协议连接和任务清理。

01 / 产品介绍

什么是远程 CDP 浏览器?

AdsCrawl 远程 CDP 浏览器通过 Chrome DevTools Protocol 提供临时云端 Chromium 会话。REST API 负责创建与删除会话,兼容客户端通过返回的连接地址控制运行中的浏览器。

实际效果

打开页面、点击 Next、读取新状态。

这是连接 AdsCrawl Remote CDP 后的 Playwright 实际运行记录:打开 JavaScript 页面,点击 Next,读取第二页,然后删除会话。

实际采集于

第一页条目
10
第二页条目
10
DELETE HTTP
200
点击 Next 后访问源页面
通过 AdsCrawl Remote CDP 中的 Playwright 点击 Next 后,采集的 Quotes to Scrape 第二页截图
向下滚动查看完整截图原始 PNG
JSON
{
  "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 的成功响应。

用自己的页面试试 →

单次公开页面演示,结果反映采集时的页面状态;目标网站、加载条件和请求设置会影响后续结果。

验证一个完整任务

用 Headless Browser API 完成两页采集

01

创建并连接

用 REST API 创建临时会话,再用 Playwright chromium.connectOverCDP 连接返回的地址。复用返回的浏览器上下文,在其中打开 Quotes to Scrape 的 JavaScript 页面。

02

翻页后验证内容

等待 .quote 渲染,读取 10 条内容;点击 Next 后,等待第二页的 .quote,再检查第一位作者为 Marilyn Monroe。不能仅凭 URL 已变化认定正文就绪。

03

在 finally 中释放

无论断言通过还是抛出异常,都删除临时会话并检查关闭结果。断开客户端连接不等于服务端会话已停止。

参考记录采集于 2026-11-04,为一次 AdsCrawl 运行;不代表所有站点的成功率、性能或费用。请下载原请求与结果,在你的目标页重新验证。

02 / 适用场景

适合哪些任务?

01

分开管理创建与操作

使用 REST API 创建浏览器,再通过 CDP 操作页面;会话 ID 用于管理,连接地址用于协议访问。

02

接入现有工具

连接 Playwright、Puppeteer 或兼容的 CDP 客户端,并检查所需操作与客户端版本的兼容性。

03

控制运行时长

设置支持的空闲和最大会话超时,跟踪活动会话,并删除已完成任务以释放并发容量。

03 / 快速开始

从一个完整流程开始

  1. 创建 API Key,检查 CDP 并发额度。
  2. 调用 POST /cdp/sessions,设置受支持的超时及浏览器参数。
  3. 使用返回地址连接;下方 Playwright 示例演示读取页面标题。
  4. 在清理流程中调用 DELETE /cdp/sessions/:sessionId 并检查响应。

示例环境:Node.js 与 Playwright(npm install playwright)。 先在服务端设置 ADSCRAWL_API_KEY 环境变量。

完整参数与响应说明 →
Playwright
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);
  }
}

04 / 限制与计费

接入前需要了解

注册获 500 一次性积分。Hobby、Starter 和 Pro 每月分别为 9、49 和 199 美元。启动持久云浏览器需要付费套餐。

比较套餐与额度 →
  • CDP 用于控制 Chromium,不是 Playwright 原生协议或 Selenium WebDriver 端点。
  • 会话按运行时设置过期,不等于持久化的浏览器配置。
  • 连接地址带有令牌,不能作为永久地址公开或缓存。
  • 断开客户端不能替代删除会话;账号限制和用量计费仍适用。

API Key 仅保存在服务端。遇到 HTTP 402 请检查额度,遇到 429 请降低并发并退避重试。

05 / FAQ

常见问题

API Key 就是 CDP 连接令牌吗?

不是。API Key 用于 REST 会话管理,协议连接使用返回的带令牌地址。

该选择什么客户端?

选择应用已支持的客户端。Playwright 和 Puppeteer 提供高级页面 API,原始 CDP 则需要自行处理命令和事件。

如何在不同任务之间保存环境?

使用云浏览器 API 的保存配置能力,不应假设临时 CDP 会话在删除或过期后仍会保留。