browserSettings、fingerprint、proxy、cookies、waitFor、field 和 actions,可以让你一致且正确地配置浏览器任务、CDP 会话和云浏览器。
browserSettings
在 CDP 会话和云浏览器之间共享的浏览器配置。省略地区时会使用随机可信代理;如果需要确定性路由,请显式传入 GLOBAL、地区代码或自定义 proxy 对象。
自定义代理配置。不能与
countryCode 同时使用。请参阅下方的 proxy schema。浏览器指纹设置。在 CDP 上下文中省略时,
canvas 和 webGlImage 默认为 "real",其他信号使用一致的随机化配置。请参阅下方的 fingerprint schema。在会话启动前注入浏览器上下文的 Cookie。请参阅下方的
cookies[] schema。示例
fingerprint
控制浏览器指纹信号以降低被检测的风险。每个字段都是可选的。浏览器任务中省略的字段默认使用 "random"。CDP browserSettings 中省略时,canvas 和 webGlImage 设置为 "real",其他信号从一致的随机化配置生成。
示例
proxy
用于路由浏览器流量的自定义代理配置。提供 server URL 形式或拆分形式(protocol + host + port),切勿同时使用两者。
完整的代理 URL,例如
"http://host:port" 或 "socks5://host:port"。必须包含显式端口。不能与 host 同时使用。请勿嵌入凭据、路径、查询字符串或片段。示例
cookies[]
在导航开始前注入浏览器上下文的 Cookie 数组。每个条目都是一个具有以下字段的对象。
示例
waitFor
指示浏览器在导航后或执行 actions 后暂停,直到页面上出现特定元素或文本。你可以在同一个对象中组合使用 selector 和 text。
示例
field(SPA 提取字段定义)
定义 POST /spa-extract 请求中要提取的单个字段。DOM 字段读取元素内容;网络字段从拦截到的 JSON 响应中捕获数据。
示例
actions[]
在 POST /spa-extract 中提取开始前执行的有序页面交互数组。每个元素都是一个带有 type 字段的对象,决定执行哪个操作。每个交互步骤的上限为 30 秒。
waitForSelector — 等待元素
waitForSelector — 等待元素
press — 按键
press — 按键
scroll — 滚动页面或元素
scroll — 滚动页面或元素
完整的 actions 示例
cloudBrowser.runtime
云浏览器端点返回的运行时状态对象。它描述了运行中或已停止的浏览器会话的当前生命周期状态。
支撑此浏览器会话的运行时类型。
"neko" 提供交互式浏览器并省略 cdpBaseUrl。"worker_cdp" 暴露 CDP 端点并可能包含 cdpBaseUrl。打开交互式浏览器的直接 URL。仅当
status 为 "running" 且 runtimeKind 为 "neko" 时存在。需要配置文件所有者的登录会话,授权使用会话 Cookie,而非查看者的 usr/pwd URL 参数。"starting" 和 "stopping" 状态都计入用户的并发运行配额。"stopping" 会话尚未释放其槽位,请轮询 GET /cloud-browsers/{id} 直到返回 "stopped" 后再假设容量可用。响应示例
Google Trends 结果元数据
成功的google-trends-explore 响应在标准 SPA 结果之外返回的额外顶级字段。这些字段描述结果是从实时浏览器会话收集的,还是从服务器缓存提供的。