继续上一次流程
需要历史浏览器环境时复用已保存的配置。继续执行前，先检查目标网站的登录状态是否仍然有效。
01 / 产品介绍
什么是云浏览器 API？
AdsCrawl 云浏览器 API 将保存的浏览器配置与运行中的会话分开管理。您可以通过 API 启动或停止配置，并在浏览器运行时打开交互式查看器。停止后的配置可以复用，无需在两次任务之间持续运行浏览器。
02 / 适用场景
适合哪些任务？
检查实时页面
登录后打开 runtime.connectUrl 查看并操作浏览器。查看器使用登录会话访问，不是公开的 API Key 链接。
分开管理环境
为需要独立 Cookie 和代理设置的流程保存不同配置。可保存配置数与同时运行数量是不同的限制。
03 / 快速开始
从一个完整流程开始
- 创建账号，确认付费套餐和云浏览器运行额度。
- 在服务端设置 ADSCRAWL_API_KEY，并将示例代理替换为自己可用的代理。
- 只发起一次启动请求，保留返回的浏览器 id，登录后打开 runtime.connectUrl。
- 结束后调用 stop，并查询详情直至 runtime.status 为 stopped。
示例环境：Bash 与 cURL。 先在服务端设置 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"
# Confirm runtime.status is "stopped"; otherwise query/retry stop.
# Closing the viewer does not stop billing.
# If launch fails, inspect its returned id; do not repeat launch.- Free 可保存配置，启动云浏览器需要付费套餐，实际并发以上限设置为准。
- 使用 API Key 时，每次启动都需要显式传入有效 proxy，已保存的代理或单独的 countryCode 不能替代。
- 关闭查看器不会停止运行计费。停止响应可能只代表 stopping，需确认最终 stopped 状态。
- launch 会创建新配置。失败后先检查返回的 id 并清理对应浏览器，不要盲目重复启动。
- 临时的 Playwright 脚本会话应使用 Remote CDP，它有独立的接口与生命周期。
API Key 仅保存在服务端。遇到 HTTP 402 请检查额度，遇到 429 请降低并发并退避重试。
05 / FAQ
常见问题
保存配置会一直占用运行额度吗？
已停止的配置不占运行名额，但会占用可保存配置数。运行中的浏览器在使用结束后需要显式停止。
登录状态可以永久保留吗？
不能。配置复用不会改变目标网站的 Cookie 有效期、登录政策或会话撤销机制，执行前需要检查状态。
可以把 API Key 放进查看器链接吗？
查看器需要登录会话。请将 API Key 保留在服务端，并按各接口文档使用对应认证方式。
