快速开始
获取你的 API Key
访问 Agent Browser 控制面板，并在设置标签页中获取你的 API key。我们将在后续步骤中使用该 API key。
参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| token | string | 在控制面板中生成的 API key。 |
| sessionTTL | number | 控制会话时长，并在超时后自动关闭浏览器实例。以秒（s）为单位，默认为 180 秒（3 分钟），可在 60 秒（1 分钟）到 900 秒之间自定义（建议最大为 15 分钟，但也可以设置更长的时间）。一旦达到指定的 TTL，会话将过期，Agent Browser 将关闭浏览器实例以释放资源。 |
| sessionName | string | 为你的会话设置一个名称，以便在历史会话列表中搜索和查看。 |
| sessionRecording | boolean | 是否启用会话录制。启用后，整个浏览器会话的执行过程将被自动录制，会话结束后可在历史会话列表详情中回放和查看。默认为 false。 |
| proxyURL | string | 用于设置浏览器的代理 URL，例如：http://user:pass@ip:port。如果设置了该参数，所有其他 proxy_* 参数都将被忽略。💡自定义代理功能目前仅对订阅用户开放。点此升级 |
| proxyCountry | string | 指定代理路由的目标国家/地区，通过所选位置的 IP 地址引导请求。接受 ISO 国家代码（例如，US 表示美国，GB 表示英国，ANY 表示随机选择）。支持 195+ 个国家和地区。与 proxyState 和 proxyCity 结合使用时，可实现精确到城市级别的地理定位。 |
| proxyState | string | （可选） 指定所选国家内的目标州/省，以实现更精细的代理路由。必须与 proxyCountry 配合使用。接受州代码（例如，CA 表示加利福尼亚州，NY 表示纽约州）。适用于已定义州/省划分的部分国家。了解更多 |
| proxyCity | string | （可选） 指定所选州/省内的目标城市，以实现城市级别的代理路由。必须与 proxyCountry 和 proxyState 配合使用。提供最精确的地理定位。可用性取决于特定城市的代理基础设施。了解更多 |
| extensionIds | string | 通过扩展 id 设置浏览器扩展，多个扩展之间用逗号分隔 |
| fingerprint | string | 浏览器指纹是利用你的浏览器和设备配置信息创建的近乎唯一的“数字指纹”，即使在没有 cookie 的情况下也可用于追踪你的在线活动。幸运的是，在 Agent Browser 中配置指纹是可选的。我们提供浏览器指纹的深度自定义，例如浏览器 user agent、时区、语言和屏幕分辨率等核心参数，并支持通过自定义启动参数扩展功能。适用于多账户管理、数据采集和隐私保护场景，使用 scrapeless 自有的 Chromium 浏览器可完全规避检测。默认情况下，我们的 Agent Browser 服务会为每个会话生成一个随机指纹。参考 |
一个完整的 Agent Browser WebSocket 连接 URL 示例：
wss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=ANYwss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=US&proxyState=CA&proxyCity=Los%20Angeleswss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyURL=proxyURL注意：当指定了 proxyURL 时，它将具有最高优先级，其他与代理相关的参数（proxyCountry、proxyState、proxyCity）将被忽略。地理代理参数必须配合使用：proxyState 需要 proxyCountry，而 proxyCity 需要同时提供 proxyCountry 和 proxyState。