01 / 产品介绍
什么是AI Agent 浏览器?
AdsCrawl 通过托管 MCP 服务、Remote CDP 会话与浏览器任务接口为 AI Agent 提供浏览器执行能力。支持 MCP 的客户端可直接接入,也可连接 Playwright 自行开发工具。任务规划、模型推理与审批规则仍由智能体应用负责。
远程 CDP 浏览器:使用临时 Chromium 会话,为智能体的交互式浏览器工具提供执行环境。
云浏览器 API:需要携带保存状态继续工作时,评估持久浏览器配置;其生命周期独立于本页智能体 CDP 示例。
按智能体工作流评估 Browserbase 替代方案 →
问题直答
AI Agent 执行需要登录的任务,应使用哪种浏览器方案?
同一任务内完成的操作可使用临时 Remote CDP 会话;需要保留 Cookie 和设置、以后继续操作时,评估保存的 Cloud Browser 配置。这是 AdsCrawl 的两套独立产品,保存配置不会自动接入下方 CDP 示例。配置复用或防检测能力不能保证一定可访问、永久登录或智能体执行成功。
- 使用已授权账号测试登录与 MFA,并按实际需要的停止、重启或重连流程验证状态。
- 持久 Cloud Browser 工作流需要付费运行额度,API Key 启动需显式代理,交互查看器需登录会话。
- 任务规划由智能体应用负责,在自己的目标网站上测量有效任务完成率和清理结果,再比较可靠性与接入耗时。
MCP / 直接连接智能体
通过 MCP 连接云浏览器
AdsCrawl MCP 让支持 Streamable HTTP 的智能体客户端直接打开浏览器、读取渲染后的页面并执行交互。它使用临时 Remote CDP 会话;任务规划仍由你的智能体负责。
- 浏览器执行端点
https://api.adscrawl.net/mcp- 传输协议
- Streamable HTTP
- 鉴权
x-api-key — 在客户端的密钥设置中保存
- 在 AdsCrawl 控制台创建 API Key,将上述端点添加为远程 MCP 服务。
- 连接后列出工具,让智能体打开公开测试页、读取标题,再关闭会话。
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,再检查内容。以下为观测结果:
- 第一页 — 10 条作者记录; Albert Einstein.
- 翻页后立即读取 — 0 条作者记录.
- 等待后再次读取 — 10 条作者记录; Marilyn Monroe.
第二页第一次读取时正文尚未出现;后续读取确认了 10 条作者记录。任务结束后 browser_close 返回 confirmed: true,状态为 stopped。这说明应检查所需内容是否就绪,不能只检查目标 URL。
单次公开页面样本,不能推导速度、成功率或持久配置表现。下载记录只保留时间、网址、数量、首位作者和关闭状态,已移除会话标识、令牌与名言正文。 下载实测记录 ↓
实际效果
打开页面、点击 Next、读取新状态。
这是连接 AdsCrawl Remote CDP 后的 Playwright 实际运行记录:打开 JavaScript 页面,点击 Next,读取第二页,然后删除会话。
实际采集于
- 第一页条目
- 10
- 第二页条目
- 10
- DELETE HTTP
- 200
向下滚动查看完整截图原始 PNG{
"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 / 快速开始
从一个完整流程开始
- 选择智能体框架,在服务端工具层保存 AdsCrawl API Key。
- 创建 Remote CDP 会话并连接 Playwright;下方示例展示浏览器连接,不是自主执行的智能体。
- 实现观察、规划和执行循环,加入工具输入校验、步数限制及重要操作审批。
- 保存所需结果,并在清理时删除远程会话,模型或工具失败时同样执行。
示例环境: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);
}
}
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。
智能体可以复用会话吗?
可在活动会话的有效期内执行多个操作。任务完成后删除会话;需要持久化环境时另行使用保存配置。