如何在OpenBrowser中使用CapSolver解决CAPTCHA（AI代理自动化指南）

// 代理等待，然后提交——CapSolver 处理其余部分
await page.waitForTimeout(30_000);
await page.click('button[type="submit"]');

# 选项 1：通过 Playwright（推荐——OpenBrowser 已经使用 Playwright）
npx playwright install chromium

# 二进制文件路径类似：
# ~/.cache/ms-playwright/chromium-XXXX/chrome-linux64/chrome  (Linux)
# ~/Library/Caches/ms-playwright/chromium-XXXX/chrome-mac/Chromium.app/Contents/MacOS/Chromium  (macOS)

# 选项 2：通过 Chrome for Testing 直接下载
# 访问：https://googlechromelabs.github.io/chrome-for-testing/
# 下载与您的操作系统匹配的版本

npm install openbrowser

git clone https://github.com/ntegrals/openbrowser.git
cd openbrowser
npm install

mkdir -p ~/.openbrowser/capsolver-extension
unzip CapSolver.Browser.Extension-chrome-v*.zip -d ~/.openbrowser/capsolver-extension/

ls ~/.openbrowser/capsolver-extension/manifest.json

export const defaultConfig = {
  apiKey: 'CAP-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',  // 请在此处输入您的密钥
  useCapsolver: true,
  // ...其余配置
};

import { LaunchProfile, OpenBrowser } from 'openbrowser';

const profile = new LaunchProfile()
  .addExtension('/home/user/.openbrowser/capsolver-extension')
  .extraArgs('--disable-extensions-except=/home/user/.openbrowser/capsolver-extension')
  .headless(false)    // 必须——MV3 扩展需要有头浏览器
  .stealthMode();     // 减少机器人检测指纹

import { LaunchProfile, OpenBrowser } from 'openbrowser';

const profile = new LaunchProfile()
  .addExtension('/home/user/.openbrowser/capsolver-extension')
  .extraArgs('--disable-extensions-except=/home/user/.openbrowser/capsolver-extension')
  .headless(false)
  .stealthMode();

const browser = await OpenBrowser.launch(profile);

// 导航到受验证码保护的页面
await browser.goto('https://example.com/protected-form');

// 等待 CapSolver 检测并解决验证码
await browser.page.waitForTimeout(30_000);

// 提交表单——验证码令牌已注入
await browser.page.click('button[type="submit"]');

// 读取目标页面或确认元素
const result = await browser.page.textContent('body');
console.log(result); // 例如，网站返回的任何确认文本

await browser.close();

import { LaunchProfile, OpenBrowser, Agent } from 'openbrowser';

const profile = new LaunchProfile()
  .addExtension('/home/user/.openbrowser/capsolver-extension')
  .extraArgs('--disable-extensions-except=/home/user/.openbrowser/capsolver-extension')
  .headless(false)
  .stealthMode();

const browser = await OpenBrowser.launch(profile);

// 创建一个使用您首选模型的代理
const agent = new Agent({
  browser,
  model: 'gpt-4o',  // 或 'claude-sonnet-4-20250514', 'gemini-pro' 等
});

// 给代理一个任务——无需提及验证码
await agent.run(`
  前往 https://example.com/contact，
  填写联系表单：
    姓名: "Jane Smith"
    邮箱: "jane@example.com"
    消息: "我想了解更多关于您的企业计划的信息。"
  等待 30 秒让页面完全加载，
  然后点击提交。
  告诉我出现的确认消息。
`);

await browser.close();

# 安装 Xvfb
sudo apt-get install -y xvfb

# 启动虚拟显示
Xvfb :99 -screen 0 1280x720x24 &

# 在运行脚本前设置 DISPLAY
export DISPLAY=:99

  您的脚本 / AI 代理
  ──────────────────────────────────────────────────
  LaunchProfile                   OpenBrowser
    .addExtension(path)   ──►  添加 --load-extension 标志
    .extraArgs(...)             添加 --disable-extensions-except
    .headless(false)            到 Playwright 启动参数
    .stealthMode()               │
                                 ▼
                            Playwright 启动 Chromium
                            ┌───────────────────────────────┐
                            │  Chromium 进程              │
                            │                                │
                            │  1. 扩展服务工作器   │
                            │     激活（background.js）  │
                            │                                │
                            │  2. 内容脚本注入   │
                            │     到每个页面            │
                            └───────────────────────────────┘
                                 │
                                 ▼
                            代理导航到目标 URL
                            ┌───────────────────────────────┐
                            │  包含验证码小部件的页面      │
                            │                                │
                            │  CapSolver 扩展：          │
                            │  1. 内容脚本检测     │
                            │     页面上的验证码        │
                            │  2. 服务工作器调用       │
                            │     CapSolver API         │
                            │  3. 接收令牌             │
                            │  4. 将令牌注入到       │
                            │     隐藏表单字段         │
                            └───────────────────────────────┘
                                 │
                                 ▼
                            代理等待（30-60 秒）...
                                 │
                                 ▼
                            代理点击提交
                                 │
                                 ▼
                            表单提交并带有有效令牌
                                 │
                                 ▼
                            网站特定的确认页面

import { LaunchProfile, OpenBrowser } from 'openbrowser';

const CAPSOLVER_API_KEY = process.env.CAPSOLVER_API_KEY!;

async function solveCaptchaViaAPI(
  pageUrl: string,
  siteKey: string
): Promise<string> {
  const createRes = await fetch("https://api.capsolver.com/createTask", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      clientKey: CAPSOLVER_API_KEY,
      task: {
        type: "ReCaptchaV2TaskProxyLess",
        websiteURL: pageUrl,
        websiteKey: siteKey,
      },
    }),
  });
  const { taskId, errorDescription } = await createRes.json();
  if (!taskId) throw new Error(`createTask失败: ${errorDescription}`);

  for (let i = 0; i < 40; i++) {
    await new Promise((r) => setTimeout(r, 3000));
    const resultRes = await fetch("https://api.capsolver.com/getTaskResult", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ clientKey: CAPSOLVER_API_KEY, taskId }),
    });
    const result = await resultRes.json();
    if (result.status === "ready") {
      return result.solution.gRecaptchaResponse;
    }
  }
  throw new Error("求解超时");
}

// 无需扩展启动 — 不需要特殊Chrome标志
const profile = new LaunchProfile()
  .headless(false)
  .stealthMode();

const browser = await OpenBrowser.launch(profile);
const page = browser.page;

await page.goto("https://example.com/protected-page");

// 检测sitekey
const siteKey = await page.evaluate(() => {
  const el = document.querySelector(".g-recaptcha[data-sitekey]");
  return el?.getAttribute("data-sitekey") ?? "";
});
console.log("Sitekey:", siteKey);

// 通过API求解
const token = await solveCaptchaViaAPI(page.url(), siteKey);
console.log("收到令牌，长度:", token.length);

// 注入令牌
await page.evaluate((t) => {
  const textarea = document.querySelector(
    'textarea[name="g-recaptcha-response"]'
  ) as HTMLTextAreaElement;
  if (textarea) textarea.value = t;
}, token);

// 提交
await page.click("#recaptcha-demo-submit");
await page.waitForLoadState("networkidle");

const body = await page.textContent("body");
console.log(
  body?.includes("Verification Success")
    ? "通过API解决CAPTCHA！"
    : body?.slice(0, 200)
);

await browser.close();

const profile = new LaunchProfile()
  .addExtension('/path/to/capsolver-extension')
  .extraArgs('--disable-extensions-except=/path/to/capsolver-extension')
  .executablePath('/path/to/chrome-for-testing/chrome')
  .headless(false)
  .stealthMode();

/path/to/your/chrome --version
# Chrome for Testing: "Chromium 143.0.7499.4"
# 品牌Chrome: "Google Chrome 143.0.7499.109"

Xvfb :99 -screen 0 1280x720x24 &
export DISPLAY=:99

const profile = new LaunchProfile()
  .addExtension('/path/to/capsolver-extension')
  .extraArgs('--disable-extensions-except=/path/to/capsolver-extension')
  .headless(false)
  .stealthMode();  // 生产环境中始终启用

# 安装Xvfb
sudo apt-get install -y xvfb

# 启动虚拟显示
Xvfb :99 -screen 0 1280x720x24 &

# 为你的OpenBrowser脚本设置DISPLAY
export DISPLAY=:99