跳转到主要内容

云浏览器 API

云浏览器 API,管理可复用的持久配置。

通过 API 创建、启动和停止浏览器配置。使用自己的代理运行完整的 AdsPower 指纹浏览器,打开实时查看器,并在下次任务中复用 Cookie 和设置。

01 / 产品介绍

什么是云浏览器 API?

AdsCrawl 云浏览器 API 用于管理托管在 AdsCrawl 云端隔离环境中的持久浏览器配置。创建配置后,可携带自己的代理启动浏览器、查询状态,并在使用结束后停止运行。每个配置运行完整的 AdsPower 指纹浏览器,提供真实原生指纹及跟随 AdsPower 的浏览器版本更新。保存的设置、Cookie 和标签页快照支持跨任务复用同一配置;登录后还可打开实时查看器,通过 WebRTC 操作浏览器。

产品操作实录 · 1:41

看看云浏览器,实际如何操作。

在 AdsCrawl 自托管的云端隔离环境中,运行功能齐全的 AdsPower 指纹浏览器。 打开网页即可远程访问,让开发测试、私密浏览和日常工作不再局限于一台设备。

AdsCrawl 官方操作实录 · 在原始视频中核对交互效果。在 YouTube 观看
  • WebRTC,让远程操作更流畅

    实时视频流传输浏览器画面,点击、输入、滚动和切换标签自然连贯,如同操作本地浏览器。

  • 完整浏览器,扩展随你装

    浏览网页、运行 Web 应用、安装浏览器插件。在熟悉的浏览器里,完成测试、研究和日常任务。

  • Cookie 持久保存,下次继续

    保存浏览器配置与 Cookie,在其他设备登录 AdsCrawl 后继续使用同一环境,减少重复配置与登录。

  • 原生指纹,独立隔离

    基于 AdsPower 原生指纹浏览器,版本跟随 AdsPower 更新。每个配置拥有独立的浏览状态,让工作与日常浏览各有空间。

在视频中查看这三个操作

  1. 01在查看器中打开远程浏览器
  2. 02点击、输入并滚动网页
  3. 03在浏览器标签页之间切换
为开发测试而生为注重隐私的你而设
查看云浏览器文档

验证一个完整任务

停止、重启,再检查保存的状态

01

建立可检查的状态

创建一个测试配置,记录配置 ID,携带有效代理启动。在查看器中打开你有权测试的网站,登录测试账号或保存一个可辨认的 Cookie。

02

停止后复用同一配置

调用停止接口并确认运行已结束;保留配置,再用同一配置 ID 和有效代理启动。关闭查看器本身不会停止计费。

03

分别检查保存和登录

检查测试 Cookie 是否仍在,以及账号页面是否仍登录。Cookie 保留不保证登录永久有效:服务端过期、撤销或重新验证都可能要求再次登录。

以上是供你复现的验收流程,不是本页新测得的登录保持结果。它验证 Cloud Browser 的持久配置;临时 Remote CDP 会话不是这套保存机制。

02 / 适用场景

适合哪些任务?

01

跨任务复用浏览器配置

保存配置 id,下次任务启动同一环境。保留的 Cookie 和标签页快照帮助您继续账号操作,登录状态仍遵循目标网站的登录与会话政策。

02

在应用中管理浏览器启停

通过 API 创建配置、携带自己的代理启动、查询运行状态,并在任务之间停止浏览器。为不同账号或测试环境维护独立配置。

03

需要时打开浏览器操作

登录实时查看器,完成账号登录、检查页面或测试 Web 应用。通过 WebRTC 交互,在完整的 AdsPower 指纹浏览器中安装扩展。

03 / 快速开始

从一个完整流程开始

  1. 创建账号,确认付费套餐和云浏览器运行额度。
  2. 在服务端设置 ADSCRAWL_API_KEY,并将示例代理替换为自己可用的代理。
  3. 只发起一次启动请求,保留返回的浏览器 id,登录后打开 runtime.connectUrl。
  4. 结束后调用 stop,并查询详情直至 runtime.status 为 stopped。

示例环境:Bash、cURL 与 jq。 先在服务端设置 ADSCRAWL_API_KEY 环境变量。

完整参数与响应说明 →
cURL
# 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;需要临时脚本会话时,选择 Remote CDP;只需单个页面的字段时,选择网页采集 API。不同流程使用各自的接口与结束步骤。

复用已保存的浏览器配置

需要回到已有浏览器环境时,使用保存的云浏览器配置。记录配置 id,在任务之间停止运行,下次启动同一配置。每次调用 launch 都会创建新配置。

查看配置保存与复用流程

执行一次临时自动化任务

Playwright 或 Puppeteer 脚本需要临时浏览器时,使用 Remote CDP。创建 CDP 会话、连接客户端,并在清理步骤中释放会话。

了解临时 CDP 会话

提取单个页面的字段

需要从动态页面获取指定字段时,使用网页采集 API。定义字段并检查返回结果,无需管理可复用的云浏览器配置。

了解结构化字段提取

如何确认结果可用

  • 将返回的配置 id 与任务一起保存,下一次运行才能启动已有配置。
  • 继续操作前确认目标账号仍然登录,登录有效期由目标网站决定。
  • 停止后查询配置,直到 runtime.status 为 stopped。stopping 状态仍占运行额度,停止后保存的配置仍可继续使用。

04 / 限制与计费

接入前需要了解

注册获 500 一次性积分。Hobby、Starter 和 Pro 每月分别为 9、49 和 199 美元。启动持久云浏览器需要付费套餐。

比较套餐与额度 →
  • Free 可保存配置,启动云浏览器需要付费套餐,实际并发以上限设置为准。
  • 使用 API Key 时,每次启动都需要显式传入有效 proxy,已保存的代理或单独的 countryCode 不能替代。
  • 关闭查看器不会停止运行计费。停止响应可能只代表 stopping,需确认最终 stopped 状态。
  • launch 会创建新配置。失败后先检查返回的 id 并清理对应浏览器,不要盲目重复启动。
  • 临时的 Playwright 脚本会话应使用 Remote CDP,它有独立的接口与生命周期。

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

05 / FAQ

常见问题

什么时候使用云浏览器 API,什么时候使用 Remote CDP?

需要保存浏览器配置,在停止后携带原有 Cookie 和设置再次启动时,使用云浏览器 API。需要临时 Playwright 或 Puppeteer 会话时,使用 Remote CDP,按其独立流程创建、连接并删除会话。云浏览器的实时查看器需要登录会话。

保存配置会一直占用运行额度吗?

已停止的配置不占运行名额,但会占用可保存配置数。运行中的浏览器在使用结束后需要显式停止。

登录状态可以永久保留吗?

不能。配置复用不会改变目标网站的 Cookie 有效期、登录政策或会话撤销机制,执行前需要检查状态。

可以把 API Key 放进查看器链接吗?

查看器需要登录会话。请将 API Key 保留在服务端,并按各接口文档使用对应认证方式。

可以安装浏览器扩展吗?

可以。完整浏览器支持按工作需要安装扩展,也可以像使用本地浏览器一样浏览网页和运行 Web 应用。

WebRTC 如何改善远程操作体验?

WebRTC 实时传输可交互的浏览器画面,为滚动、输入和日常浏览提供流畅体验。实际响应速度取决于网络连接与运行环境。