Skip to content

浏览器扩展安装指南

CaptchaSonic 浏览器扩展是您在日常浏览或 Selenium 等自动化框架中求解 CAPTCHA 的最简单方式。本指南介绍其在所有受支持浏览器上的安装与配置。

🚀 关键特性

  • 零点击求解：自动检测并启动主流 CAPTCHA 的求解流程。
  • 隐形模式：在后台运行，不影响您的视野。
  • 广泛兼容：支持 reCAPTCHA（v2/v3/Invisible）、hCaptcha、GeeTest 等。
  • 黑名单支持：可设置在特定域名上禁用自动求解。

1. 前置条件

安装前，您需要：

  1. 一个 CaptchaSonic 账户。
  2. 在 控制台 中获取 API Key。

[!IMPORTANT] 您的 API key 属于私密信息。请勿分享或提交到公开仓库。

2. 安装

Google Chrome

由于我们的扩展会频繁更新 AI 模型，建议使用"未打包"版本以获得最新功能。

  1. 从应用商店安装：最简单的方式 —— 直接从 Chrome 应用商店 添加。

或获取最新未发布的版本：

  1. 下载：从我们的 GitHub Releases 获取最新扩展 ZIP。
  2. 解压：将下载的文件夹解压到电脑上的固定位置。
  3. 管理扩展：打开 Chrome 并进入 chrome://extensions/。
  4. 开发者模式：开启右上角的 Developer Mode 开关。
  5. 加载未打包扩展：点击 Load unpacked 按钮，选择解压后的文件夹。

Chrome Extension Setup Steps

Mozilla Firefox

  1. 从应用商店安装：直接从 Firefox 附加组件 添加。

或通过 .xpi 手动安装：

  1. 下载：从我们的 GitHub Releases 获取 .xpi。
  2. 附加组件菜单：打开 Firefox，点击菜单按钮（三条横线），选择 Add-ons and Themes。
  3. 从文件安装：点击已管理扩展上方的齿轮图标，选择 Install Add-on From File...。
  4. 确认：选中 .xpi 文件并点击 Add。

3. 配置

安装完成后，点击浏览器工具栏中的 CaptchaSonic 图标打开设置面板。

  1. 身份认证：在第一个字段中粘贴您的 API Key，并点击 Save。
  2. 启用模块：开启您希望自动求解的具体 CAPTCHA 类型。
  3. 高级选项：
    • 求解延迟：如果想表现得更像真人，可设置延迟。
    • 自动提交：挑战解决后自动点击"Verify"。

Extension Settings UI

4. 使用

扩展秉持"一次设置，永久生效"的理念。

  • 检测：当您访问带有 CAPTCHA 的页面时，扩展图标会变化以表示已发现挑战。
  • 状态：CAPTCHA 控件附近可能会出现一个状态徽章，显示求解进度。
  • 完成：解决后，扩展会将结果令牌填入对应字段，并按配置提交表单。

5. 故障排查（FAQ）

问：扩展未能解决 CAPTCHA。

  • 答：检查您的 控制台 余额是否充足。确认 API key 已正确粘贴。

问：reCAPTCHA v3 出现"Low Score"错误。

  • 答：reCAPTCHA v3 依赖您的浏览器历史和 IP 信誉。请尝试高质量代理或清理浏览器缓存。

问：Chrome 提示扩展"损坏"。

  • 答：这通常发生在加载扩展后您又移动了其文件夹。请在 chrome://extensions/ 中移除并重新点击 "Load unpacked"。

6. 支持

如果您遇到持续性问题，请通过 官方控制台 的实时聊天联系我们的技术团队。

[!TIP] 开发者提示：如果您要进行高量爬虫，请考虑使用我们的 REST API，而非浏览器扩展 —— 吞吐量会显著更高。