建立可检查的状态
创建一个测试配置,记录配置 ID,携带有效代理启动。在查看器中打开你有权测试的网站,登录测试账号或保存一个可辨认的 Cookie。
01 / 产品介绍
AdsCrawl 云浏览器 API 用于管理托管在 AdsCrawl 云端隔离环境中的持久浏览器配置。创建配置后,可携带自己的代理启动浏览器、查询状态,并在使用结束后停止运行。每个配置运行完整的 AdsPower 指纹浏览器,提供真实原生指纹及跟随 AdsPower 的浏览器版本更新。保存的设置、Cookie 和标签页快照支持跨任务复用同一配置;登录后还可打开实时查看器,通过 WebRTC 操作浏览器。
远程 CDP 浏览器:脚本自动化不需要保存配置时,选择临时 Chromium 会话。
登录态网页抓取:需要登录后访问内容时,了解登录检查、账号隔离与配置复用流程。
产品操作实录 · 1:41
在 AdsCrawl 自托管的云端隔离环境中,运行功能齐全的 AdsPower 指纹浏览器。 打开网页即可远程访问,让开发测试、私密浏览和日常工作不再局限于一台设备。
实时视频流传输浏览器画面,点击、输入、滚动和切换标签自然连贯,如同操作本地浏览器。
浏览网页、运行 Web 应用、安装浏览器插件。在熟悉的浏览器里,完成测试、研究和日常任务。
保存浏览器配置与 Cookie,在其他设备登录 AdsCrawl 后继续使用同一环境,减少重复配置与登录。
基于 AdsPower 原生指纹浏览器,版本跟随 AdsPower 更新。每个配置拥有独立的浏览状态,让工作与日常浏览各有空间。
验证一个完整任务
创建一个测试配置,记录配置 ID,携带有效代理启动。在查看器中打开你有权测试的网站,登录测试账号或保存一个可辨认的 Cookie。
调用停止接口并确认运行已结束;保留配置,再用同一配置 ID 和有效代理启动。关闭查看器本身不会停止计费。
检查测试 Cookie 是否仍在,以及账号页面是否仍登录。Cookie 保留不保证登录永久有效:服务端过期、撤销或重新验证都可能要求再次登录。
以上是供你复现的验收流程,不是本页新测得的登录保持结果。它验证 Cloud Browser 的持久配置;临时 Remote CDP 会话不是这套保存机制。
02 / 适用场景
保存配置 id,下次任务启动同一环境。保留的 Cookie 和标签页快照帮助您继续账号操作,登录状态仍遵循目标网站的登录与会话政策。
通过 API 创建配置、携带自己的代理启动、查询运行状态,并在任务之间停止浏览器。为不同账号或测试环境维护独立配置。
登录实时查看器,完成账号登录、检查页面或测试 Web 应用。通过 WebRTC 交互,在完整的 AdsPower 指纹浏览器中安装扩展。
03 / 快速开始
示例环境:Bash、cURL 与 jq。 先在服务端设置 ADSCRAWL_API_KEY 环境变量。
完整参数与响应说明 →# Replace the proxy address with your own proxy.
curl --fail-with-body -sS --max-time 200 \
-X POST "https://api.adscrawl.net/cloud-browsers/launch" \
-H "x-api-key: $ADSCRAWL_API_KEY" \
-H "content-type: application/json" \
-d '{
"proxy": { "server": "http://proxy.example.com:8080" },
"tabs": ["https://www.adscrawl.net"]
}'
# Open runtime.connectUrl from the response.
# When finished, replace <browser-id> with the returned id.
curl --fail-with-body -sS -X POST \
"https://api.adscrawl.net/cloud-browsers/<browser-id>/stop" \
-H "x-api-key: $ADSCRAWL_API_KEY"
# Requires jq. Replace <browser-id> with the same id used above.
# A successful stop request can still return status "stopping".
BROWSER_ID="<browser-id>"
stopped=false
for ((attempt=0; attempt<60; attempt++)); do
detail=$(curl --fail-with-body -sS --max-time 30 \
"https://api.adscrawl.net/cloud-browsers/$BROWSER_ID" \
-H "x-api-key: $ADSCRAWL_API_KEY") || exit 1
status=$(printf '%s' "$detail" | jq -er '.runtime.status') || exit 1
if [ "$status" = "stopped" ]; then
stopped=true
break
fi
sleep 2
done
if [ "$stopped" != true ]; then
printf '%s\n' 'Shutdown is not confirmed. Check this profile; do not launch a replacement.' >&2
exit 1
fi
# Closing the viewer does not stop billing.
# If launch fails, inspect its returned id; do not repeat launch.工作流指南
需要停止后继续复用保存的配置时,选择云浏览器 API;需要临时脚本会话时,选择 Remote CDP;只需单个页面的字段时,选择网页采集 API。不同流程使用各自的接口与结束步骤。
需要回到已有浏览器环境时,使用保存的云浏览器配置。记录配置 id,在任务之间停止运行,下次启动同一配置。每次调用 launch 都会创建新配置。
查看配置保存与复用流程Playwright 或 Puppeteer 脚本需要临时浏览器时,使用 Remote CDP。创建 CDP 会话、连接客户端,并在清理步骤中释放会话。
了解临时 CDP 会话需要从动态页面获取指定字段时,使用网页采集 API。定义字段并检查返回结果,无需管理可复用的云浏览器配置。
了解结构化字段提取API Key 仅保存在服务端。遇到 HTTP 402 请检查额度,遇到 429 请降低并发并退避重试。
05 / FAQ
需要保存浏览器配置,在停止后携带原有 Cookie 和设置再次启动时,使用云浏览器 API。需要临时 Playwright 或 Puppeteer 会话时,使用 Remote CDP,按其独立流程创建、连接并删除会话。云浏览器的实时查看器需要登录会话。
已停止的配置不占运行名额,但会占用可保存配置数。运行中的浏览器在使用结束后需要显式停止。
不能。配置复用不会改变目标网站的 Cookie 有效期、登录政策或会话撤销机制,执行前需要检查状态。
查看器需要登录会话。请将 API Key 保留在服务端,并按各接口文档使用对应认证方式。
可以。完整浏览器支持按工作需要安装扩展,也可以像使用本地浏览器一样浏览网页和运行 Web 应用。
WebRTC 实时传输可交互的浏览器画面,为滚动、输入和日常浏览提供流畅体验。实际响应速度取决于网络连接与运行环境。