使用 CaptchaSonic 进行浏览器自动化

将 CaptchaSonic 集成到您的浏览器自动化流程中，可以无需人工介入地绕过复杂的 CAPTCHA 挑战。本指南将介绍如何在自动化环境中安装、配置和使用 CaptchaSonic 扩展。

---

1. 开始使用

在自动化脚本中使用扩展之前，您需要从 CaptchaSonic 控制台获取一个有效的 API key。

1. 创建账户：在 captchasonic.com 注册。
2. 获取 API Key：登录 控制台 并复制您的专属 API key。

---

2. 安装与配置

Chrome/Chromium 系浏览器

如果您未使用持久化浏览器配置，自动化框架通常需要"硬编码"的 API key。

1. 下载源码：克隆或下载 CaptchaSonic 扩展仓库。
2. 配置 API Key：
   • 进入扩展源码中的 config 文件夹。
   • 打开默认配置文件（通常为 config.json 或类似文件）。
   • 将您的 API key 粘贴到 apiKey 字段。
3. 在 Chrome 中加载：
   • 打开 chrome://extensions/。
   • 启用 Developer Mode。
   • 点击 Load unpacked 并选择修改后的扩展文件夹。

Firefox

1. 下载 XPI：可从 Firefox 附加组件商店 安装，或从 CaptchaSonic 扩展 Releases 获取最新构建。
2. 手动安装：进入 about:addons，点击齿轮图标，选择 Install Add-on From File。

---

3. 自动化框架集成

要在代码中使用扩展，您必须指定扩展文件夹或文件的路径。

Selenium (Python)

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

chrome_options = Options()
chrome_options.add_argument("--load-extension=/path/to/extracted/extension")

driver = webdriver.Chrome(options=chrome_options)
driver.get("https://web.captcha-target.com")

Playwright (Node.js)

const { chromium } = require('playwright');

(async () => {
  const pathToExtension = require('path').join(__dirname, 'my-extension');
  const userDataDir = '/tmp/test-user-data-dir';
  const browserContext = await chromium.launchPersistentContext(userDataDir, {
    headless: false,
    args: [
      `--disable-extensions-except=${pathToExtension}`,
      `--load-extension=${pathToExtension}`,
    ],
  });
  // ... 您的自动化逻辑
})();

---

4. 参数配置

在扩展弹窗或配置文件中，您可以微调 CAPTCHA 的处理方式：

• Auto-Solve：检测到 CAPTCHA 时自动触发求解。
• Solve Delay：在求解前增加自然延迟以模拟人类行为。
• Target Types：启用/禁用针对 reCAPTCHA、hCaptcha、GeeTest 等的特定求解器。

---

5. 部署注意事项

• Headless 模式：标准扩展无法在"True Headless"模式（--headless=new）下运行。请使用 --headless=old，或在 Linux 服务器上使用虚拟帧缓冲（Xvfb）。
• 代理支持：大多数扩展会沿用自动化框架配置的浏览器系统代理设置。

---

6. 结语

通过集成 CaptchaSonic 扩展，您可以显著降低浏览器自动化中处理交互式挑战的复杂度。

如需进一步的技术支持或自定义集成需求，请通过 控制台 联系我们的团队。