观察当前页面
使用客户端读取页面文本或截图，把必要的信息传给模型，并为结果保留页面 URL。
01 / 产品介绍
什么是AI Agent 浏览器？
AdsCrawl 通过 Remote CDP 会话与浏览器任务接口为 AI Agent 提供浏览器执行能力。智能体可使用这些工具观察网页并执行浏览器操作，任务规划、模型推理与审批规则则由智能体应用负责。
02 / 适用场景
适合哪些任务？
执行受控操作
把模型选择映射为明确的导航或字段交互工具，校验输入，并在每次操作后检查页面状态。
按任务选择接口
只读内容任务使用 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(await res.text());
const session = await res.json();
try {
const browser = await chromium.connectOverCDP(
session.cdpBaseUrl
);
const page = await browser.contexts()[0].newPage();
await page.goto("https://www.adscrawl.net");
console.log(await page.title());
} finally {
const stopped = await fetch(
base + "/cdp/sessions/" + session.sessionId,
{ method: "DELETE", headers }
);
if (!stopped.ok) throw new Error(await stopped.text());
}- AdsCrawl 提供浏览器执行能力，不提供托管大模型、任务规划器或任务成功保证。
- 网页内容属于不可信输入，应与智能体权限及用户指令分开处理。
- 模型 Token 与浏览器用量分别计费，应用需设置操作预算与会话超时。
- 框架需支持所选 CDP 或 HTTP 工具，本页不表示与所有智能体框架均有原生集成。
API Key 仅保存在服务端。遇到 HTTP 402 请检查额度，遇到 429 请降低并发并退避重试。
05 / FAQ
常见问题
传入目标后 API 会自己完成任务吗？
此处接口执行浏览器操作，规划、工具调用与任务完成检查需要由应用实现。
智能体必须一直运行浏览器吗？
不需要。获取可读正文可使用 POST /html 的 Markdown 输出，多步交互再选择 Remote CDP。
智能体可以复用会话吗？
可在活动会话的有效期内执行多个操作。任务完成后删除会话；需要持久化环境时另行使用保存配置。
