跳转到主要内容

AI Agent 浏览器

面向 AI Agent 的云浏览器 API

把智能体工具层连接到真实云端浏览器。应用负责选择模型和操作策略,AdsCrawl 提供浏览器会话。

01 / 产品介绍

什么是AI Agent 浏览器?

AdsCrawl 通过托管 MCP 服务、Remote CDP 会话与浏览器任务接口为 AI Agent 提供浏览器执行能力。支持 MCP 的客户端可直接接入,也可连接 Playwright 自行开发工具。任务规划、模型推理与审批规则仍由智能体应用负责。

问题直答

AI Agent 执行需要登录的任务,应使用哪种浏览器方案?

同一任务内完成的操作可使用临时 Remote CDP 会话;需要保留 Cookie 和设置、以后继续操作时,评估保存的 Cloud Browser 配置。这是 AdsCrawl 的两套独立产品,保存配置不会自动接入下方 CDP 示例。配置复用或防检测能力不能保证一定可访问、永久登录或智能体执行成功。

  1. 使用已授权账号测试登录与 MFA,并按实际需要的停止、重启或重连流程验证状态。
  2. 持久 Cloud Browser 工作流需要付费运行额度,API Key 启动需显式代理,交互查看器需登录会话。
  3. 任务规划由智能体应用负责,在自己的目标网站上测量有效任务完成率和清理结果,再比较可靠性与接入耗时。

MCP / 直接连接智能体

通过 MCP 连接云浏览器

AdsCrawl MCP 让支持 Streamable HTTP 的智能体客户端直接打开浏览器、读取渲染后的页面并执行交互。它使用临时 Remote CDP 会话;任务规划仍由你的智能体负责。

浏览器执行端点
https://api.adscrawl.net/mcp
传输协议
Streamable HTTP
鉴权
x-api-key — 在客户端的密钥设置中保存
  1. 在 AdsCrawl 控制台创建 API Key,将上述端点添加为远程 MCP 服务。
  2. 连接后列出工具,让智能体打开公开测试页、读取标题,再关闭会话。
  3. browser_open → browser_read → browser_close。需要导航时使用 browser_navigate;确认关闭结果中 confirmed: true。
使用 AdsCrawl 的美国线路打开 https://example.com,读取页面标题,然后关闭浏览器并确认已停止。

预期标题为 Example Domain。browser_open 会启动计费会话,结束或发生错误后都应关闭。browser_screenshot 会发布任何持链接者可查看的 JPEG,调用前需获得发布许可。

免费套餐含 500 一次性积分,可用于支持的临时会话;持久 Cloud Browser 配置的启动需要付费套餐。MCP 会话共享 API Key 的并发额度,遇到 429 应释放会话或等待可用容量。

https://docs.adscrawl.net/mcp 用于文档搜索,是另一个服务。浏览器交互请使用上方 api.adscrawl.net 端点。

一次真实 MCP 翻页记录

2026-11-12,通过美国线路打开 Quotes to Scrape 的 JavaScript 测试页,读取页面、点击 Next,再检查内容。以下为观测结果:

  1. 第一页 — 10 条作者记录; Albert Einstein.
  2. 翻页后立即读取 — 0 条作者记录.
  3. 等待后再次读取 — 10 条作者记录; Marilyn Monroe.

第二页第一次读取时正文尚未出现;后续读取确认了 10 条作者记录。任务结束后 browser_close 返回 confirmed: true,状态为 stopped。这说明应检查所需内容是否就绪,不能只检查目标 URL。

单次公开页面样本,不能推导速度、成功率或持久配置表现。下载记录只保留时间、网址、数量、首位作者和关闭状态,已移除会话标识、令牌与名言正文。 下载实测记录 ↓

实际效果

打开页面、点击 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 的成功响应。

用自己的页面试试 →

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

02 / 适用场景

适合哪些任务?

01

观察当前页面

使用客户端读取页面文本或截图,把必要的信息传给模型,并为结果保留页面 URL。

02

执行受控操作

把模型选择映射为明确的导航或字段交互工具,校验输入,并在每次操作后检查页面状态。

03

按任务选择接口

只读内容任务使用 Markdown 或结构化提取,需要多步交互时再创建 CDP 会话。

03 / 快速开始

从一个完整流程开始

  1. 选择智能体框架,在服务端工具层保存 AdsCrawl API Key。
  2. 创建 Remote CDP 会话并连接 Playwright;下方示例展示浏览器连接,不是自主执行的智能体。
  3. 实现观察、规划和执行循环,加入工具输入校验、步数限制及重要操作审批。
  4. 保存所需结果,并在清理时删除远程会话,模型或工具失败时同样执行。

示例环境: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 美元。启动持久云浏览器需要付费套餐。

比较套餐与额度 →
  • AdsCrawl 提供浏览器执行能力,不提供托管大模型、任务规划器或任务成功保证。
  • 网页内容属于不可信输入,应与智能体权限及用户指令分开处理。
  • 模型 Token 与浏览器用量分别计费,应用需设置操作预算与会话超时。
  • 框架需支持所选 CDP 或 HTTP 工具,本页不表示与所有智能体框架均有原生集成。

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

05 / FAQ

常见问题

传入目标后 API 会自己完成任务吗?

此处接口执行浏览器操作,规划、工具调用与任务完成检查需要由应用实现。

可以通过 MCP 接入 AI Agent 吗?

可以。使用 https://api.adscrawl.net/mcp、Streamable HTTP 和保存在客户端密钥设置中的 x-api-key。发现浏览器工具后打开并读取页面,结束时调用 browser_close,检查 confirmed: true。docs.adscrawl.net 的 MCP 是另一个用于文档搜索的服务。

智能体必须一直运行浏览器吗?

不需要。获取可读正文可使用 POST /html 的 Markdown 输出,多步交互再选择 Remote CDP。

智能体可以复用会话吗?

可在活动会话的有效期内执行多个操作。任务完成后删除会话;需要持久化环境时另行使用保存配置。