跳转到主要内容

验证码解算器

使用抓取浏览器浏览页面时,默认情况下,我们的集成验证码解算器会自动解算所有验证码 。您可以使用以下自定义 CDP 函数在代码中监控此自动解算过程。
如果您想通过控制面板完全禁用验证码解算器,请参阅我们的禁用验证码解算器功能:
https://docs.brightdata.com/cn/scraping-automation/scraping-browser/features/captcha-solver
验证码解算后,如有表单需要提交,则默认情况下会提交。

验证码解算器 - 自动解算

使用此指令返回验证码已解算、失败或未检测到之后的状态。 使用此指令返回验证码已解算、失败或未检测到之后的状态。
示例
如果验证码解算失败,请重新尝试。 如果问题仍然存在,请提交支持请求 ,详细说明您遇到的具体问题。
使用以下指令查明验证码解算流程中更具体的阶段:示例
以下代码设置 CDP 会话、监听 CAPTCHA 事件并处理超时:

验证码解算器 - 手动控制

如果您想手动配置或完全禁用我们的默认验证码解算器,请改为手动调用解算器或自己解算,请参阅以下 CDP 指令和功能。
此指令用于控制验证码的自动解算。 您可以禁用自动解算或为不同的验证码类型配置算法,然后手动触发此操作:
在会话中完全禁用自动解算器的 CDP 指令示例:
对于以下三种验证码类型,我们支持以下附加选项,以控制和配置我们的自动解算算法。
CF Challenge

仿真函数

使用此指令获取所有可仿真的设备列表。 此方法返回可与 setDevice 指令一起使用的设备选项阵列。
示例
收到上面的支持设备列表后,您可以使用 Emulation.setDevice 指令模拟特定设备。此指令更改屏幕宽度、高度、userAgent 和 devicePixelRatio 以匹配指定的设备。

横向模式

如果您想将方向更改为横向(适用于支持横向的设备),可在device_name 之后添加字符串landscape。
示例

广告拦截器

启用我们的 AdBlock 功能可以帮助 减少带宽 使用并 提升广告密集型网站的性能

CDP 命令

  • Unblocker.enableAdBlock – 启用广告拦截器(默认:关闭)
  • Unblocker.disableAdBlock – 禁用广告拦截器
我们建议在导航至目标页面之前启用广告拦截。
Example
查看完整的 广告拦截示例脚本

会话持久化

使用此命令可以在多个浏览会话中重用同一个代理节点。这在需要保持会话一致性(如保留浏览器状态或基于 IP 的连续性)的场景中非常有用。

CDP 命令

  • Proxy.useSession – 将会话与特定的 session ID 关联。
  • sessionId – 唯一标识你的会话的字符串。
在导航至目标页面之前使用 CDP 命令。
Example
查看完整的 会话持久化示例脚本

文件下载

你可以在 Browser API 流程中使用自定义 Download CDP 域自动化文件下载。这对于需要在浏览器自动化过程中直接下载文件(例如 CSV、PDF)的工作流非常有用。

CDP 命令

  • Download.enable – 启用指定内容类型的文件下载。
  • Download.downloadRequest – 当请求产生下载时触发。
  • Download.getLastCompleted – 获取上一次完成的下载信息。
  • Download.getDownloadedBody – 获取实际下载的文件内容。
Example
查看完整的 文件下载示例脚本

更快的文本输入

对于需要快速或批量文本输入的场景,使用自定义 Input.type CDP 命令。这种方法比标准 CDP 文本输入方法更快,非常适合需要高速输入或处理大量文本的自动化任务。

CDP 命令

  • Input.type - 向当前聚焦的元素发送按键或模拟输入指定文本。
Example

自定义客户端 SSL/TLS 证书

使用此命令可在特定域认证所需时安装自定义客户端 SSL/TLS 证书。这些证书在 单次 Browser API 会话期间应用,并在会话结束后自动移除。
  • 用有效的 Browser API 凭据替换占位符 SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD
  • client.pfx 替换为实际证书文件路径,该文件应为有效的 .pfx 格式 SSL/TLS 客户端证书。
  • secret 替换为证书的实际密码。