SuperAPI AI 工具集

headless-browser

测试与质量

查看项目

更新于 10-16 09:50

技能介绍

用途:通过 WebSocket 连接 Oxylabs 远程无头浏览器,用现有 CDP 库(推荐 Playwright 的 chromium.connectOverCDP,也支持 Puppeteer puppeteer.connect 及任意 CDP 客户端)驱动云端 Chrome 会话,本地不运行浏览器,用完关闭会话。

主要能力:内置反检测、住宅代理轮换与地理定位;每个会话默认获得全新指纹和全新住宅 IP;支持命名可恢复会话、粘性 IP、存储配置文件(o_profile)、录制与实时检查。

连接方式:端点为 wss://USERNAME:PASSWORD@hb.oxylabs.io,凭据用 OXY_UNBLOCKER_USERNAME / OXY_UNBLOCKER_PASSWORD(别名 OXY_HB_USERNAME / OXY_HB_PASSWORD),选项仅通过 URL 查询参数传入,如 ?p_cc=US&session_name=job-42。必须用 wss://;URL 需用字符串拼接原始密码,不要经 new URL() 或 urllib.parse 处理,否则密码被百分号编码导致认证失败;用户名须与仪表盘完全一致(含后缀)。密码含冒号时无法放入 URL,需改用 Authorization: Basic 头。

限制:账户默认每秒新建 10 个会话、并发 100、命名会话 5、存储配置文件 5、录制 10、并发检查查看器 10;会话最长存活 1 小时;命名会话断开后可恢复 10 分钟;未关闭会话会占用并发槽位。受限目标(流媒体、金融、政府、游戏、票务、网页邮箱、广告网络等)默认屏蔽,需通过客户经理完成 KYC。

使用要点:始终在 finally 中 browser.close();对 429、5xx 等可重试错误做退避重试,400/401/403 应修正而非重试;默认屏蔽图片、样式表、媒体和字体;不要自行设置视口或设备指标;被拦截时按升级阶梯逐级尝试,不要重复相同请求。调试可用实时检查(__session_id 命令获取会话 id 后打开 https://hb.oxylabs.io/novnc/?id=<id>)和录制(record=true&record_name=<job>)。

适用场景:需要反检测与地理定位的网页数据抓取、独立页面批量抓取、需要登录或 Cookie 存活的认证抓取。具体参数、错误码与模板见随附的 scripts/、parameters.md、errors.md、examples.md、targets.md。