使用 Node.js 和 CaptchaAI 解决 Puppeteer CAPTCHA 问题 (实用指南)

Puppeteer 是 Node.js 自动化的首选无头浏览器。当目标站点提供验证码时，CaptchaAI 的 API 从外部解决它们 - Puppeteer 提取参数，CaptchaAI 返回令牌，然后 Puppeteer 将其注入回来。

要求

要求	细节
Node.js 16+	使用 npm
Puppeteer	`npm install puppeteer`
轴	`npm install axios`
CaptchaAI API 密钥	从验证码网站

它是如何运作的

Puppeteer 使用验证码导航到页面
您的脚本从 DOM 中提取 CAPTCHA 站点密钥
CaptchaAI 解决了服务器端的挑战
您的脚本注入令牌并提交表单

第 1 步：创建求解器模块

// solver.js
const axios = require("axios");

const API_KEY = "YOUR_API_KEY";
const POLL_INTERVAL = 5000;
const MAX_ATTEMPTS = 60;

async function solveRecaptchaV2(siteKey, pageUrl) {
  // Submit task
  const submitResp = await axios.get("https://ocr.captchaai.com/in.php", {
    params: {
      key: API_KEY,
      method: "userrecaptcha",
      googlekey: siteKey,
      pageurl: pageUrl,
    },
  });

  if (!submitResp.data.startsWith("OK|")) {
    throw new Error(`Submit failed: ${submitResp.data}`);
  }

  const taskId = submitResp.data.split("|")[1];
  console.log(`Task submitted: ${taskId}`);

  // Poll for result
  for (let i = 0; i < MAX_ATTEMPTS; i++) {
    await new Promise((r) => setTimeout(r, POLL_INTERVAL));

    const result = await axios.get("https://ocr.captchaai.com/res.php", {
      params: { key: API_KEY, action: "get", id: taskId },
    });

    if (result.data === "CAPCHA_NOT_READY") continue;
    if (result.data.startsWith("OK|")) {
      return result.data.split("|")[1];
    }
    throw new Error(`Solve failed: ${result.data}`);
  }
  throw new Error("Solve timed out");
}

async function solveTurnstile(siteKey, pageUrl) {
  const submitResp = await axios.get("https://ocr.captchaai.com/in.php", {
    params: {
      key: API_KEY,
      method: "turnstile",
      sitekey: siteKey,
      pageurl: pageUrl,
    },
  });

  if (!submitResp.data.startsWith("OK|")) {
    throw new Error(`Submit failed: ${submitResp.data}`);
  }

  const taskId = submitResp.data.split("|")[1];

  for (let i = 0; i < MAX_ATTEMPTS; i++) {
    await new Promise((r) => setTimeout(r, POLL_INTERVAL));
    const result = await axios.get("https://ocr.captchaai.com/res.php", {
      params: { key: API_KEY, action: "get", id: taskId },
    });
    if (result.data === "CAPCHA_NOT_READY") continue;
    if (result.data.startsWith("OK|")) return result.data.split("|")[1];
    throw new Error(`Solve failed: ${result.data}`);
  }
  throw new Error("Solve timed out");
}

module.exports = { solveRecaptchaV2, solveTurnstile };

第 2 步：设置 Puppeteer (默认配置)功能

const puppeteer = require("puppeteer");

async function createBrowser() {
  const browser = await puppeteer.launch({
    headless: "new",
    args: [
      "--no-sandbox",
      "--disable-setuid-sandbox",
      "--no-sandbox",
    ],
  });

  const page = await browser.newPage();
  await page.setUserAgent(
    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
  );

  // Hide automation indicators
  await page.evaluateOnNewDocument(() => {
    Object.defineProperty(navigator, "webdriver", { get: () => false });
  });

  return { browser, page };
}

步骤 3：解决页面上的 reCAPTCHA 问题

const { solveRecaptchaV2 } = require("./solver");

async function scrapeWithCaptcha(url) {
  const { browser, page } = await createBrowser();

  try {
    await page.goto(url, { waitUntil: "networkidle2" });

    // Extract site key
    const siteKey = await page.$eval(
      ".g-recaptcha",
      (el) => el.getAttribute("data-sitekey")
    );
    console.log("Site key:", siteKey);

    // Solve with CaptchaAI
    const token = await solveRecaptchaV2(siteKey, url);
    console.log("Token received:", token.substring(0, 50));

    // Inject token
    await page.evaluate((token) => {
      document.getElementById("g-recaptcha-response").innerHTML = token;
      document.getElementById("g-recaptcha-response").style.display = "";
    }, token);

    // Submit the form
    await page.click('button[type="submit"]');
    await page.waitForNavigation({ waitUntil: "networkidle2" });

    // Scrape the content
    const content = await page.content();
    console.log("Page loaded successfully");
    return content;
  } finally {
    await browser.close();
  }
}

第 4 步：处理回调

有些网站使用 JavaScript 回调而不是表单提交：

// Trigger the reCAPTCHA callback
await page.evaluate((token) => {
  // Method 1: Direct callback
  if (typeof ___grecaptcha_cfg !== "undefined") {
    const clients = ___grecaptcha_cfg.clients;
    Object.keys(clients).forEach((key) => {
      const client = clients[key];
      // Find the callback function
      const findCallback = (obj) => {
        for (const prop in obj) {
          if (typeof obj[prop] === "function") {
            obj[prop](token);
            return true;
          }
          if (typeof obj[prop] === "object" && obj[prop] !== null) {
            if (findCallback(obj[prop])) return true;
          }
        }
        return false;
      };
      findCallback(client);
    });
  }
}, token);

完整的工作示例

const puppeteer = require("puppeteer");
const axios = require("axios");

const API_KEY = "YOUR_API_KEY";

async function solveCaptcha(siteKey, pageUrl) {
  const submit = await axios.get("https://ocr.captchaai.com/in.php", {
    params: {
      key: API_KEY,
      method: "userrecaptcha",
      googlekey: siteKey,
      pageurl: pageUrl,
    },
  });
  const taskId = submit.data.split("|")[1];

  while (true) {
    await new Promise((r) => setTimeout(r, 5000));
    const result = await axios.get("https://ocr.captchaai.com/res.php", {
      params: { key: API_KEY, action: "get", id: taskId },
    });
    if (result.data === "CAPCHA_NOT_READY") continue;
    if (result.data.startsWith("OK|")) return result.data.split("|")[1];
    throw new Error(result.data);
  }
}

(async () => {
  const browser = await puppeteer.launch({
    headless: "new",
    args: ["--no-sandbox"],
  });
  const page = await browser.newPage();

  try {
    await page.goto("https://staging.example.com/qa-login", {
      waitUntil: "networkidle2",
    });

    // Get the site key
    const siteKey = await page.$eval(".g-recaptcha", (el) =>
      el.getAttribute("data-sitekey")
    );

    // Solve
    const token = await solveCaptcha(siteKey, page.url());

    // Inject and submit
    await page.evaluate((t) => {
      document.getElementById("g-recaptcha-response").innerHTML = t;
    }, token);

    await page.click("#submit-btn");
    await page.waitForNavigation();

    console.log("Done:", page.url());
  } finally {
    await browser.close();
  }
})();

故障排除

问题	原因	处理方式
`page.$eval` 失败	初始渲染后加载验证码	使用`page.waitForSelector('.g-recaptcha')`
令牌不起作用	提交前已过期	收到后立即注射
站点检测到 Puppeteer	缺少标准配置	使用`puppeteer (默认配置)`
`Navigation timeout`	提交后页面未导航	检查网站是否使用 AJAX 而不是表单发布

常问问题

我应该使用无头模式还是有头模式？

无头模式与 CaptchaAI 配合良好，因为验证码是在服务器端解析的。仅使用 head 模式进行调试。

我可以将 Puppeteer 与 Cloudflare Turnstile 一起使用吗？

是的。从 .cf-turnstile div 中提取 data-sitekey 并将 method=turnstile 与 CaptchaAI 一起使用。请参阅上面的 solveTurnstile 函数。

如何在一页上处理多个验证码？

分别提取每个站点密钥并使用 Promise.all() 并行求解它们。

使用 Node.js 和 CaptchaAI 解决 Puppeteer CAPTCHA 问题

要求

它是如何运作的

第 1 步：创建求解器模块

第 2 步：设置 Puppeteer (默认配置)功能

步骤 3：解决页面上的 reCAPTCHA 问题

第 4 步：处理回调

完整的工作示例

故障排除

常问问题

我应该使用无头模式还是有头模式？

我可以将 Puppeteer 与 Cloudflare Turnstile 一起使用吗？

如何在一页上处理多个验证码？

相关指南

使用 Node.js 进行验证码抓取：完整教程

Puppeteer + CaptchaAI 用于自有浏览器流程的 QA 测试

面向自有 QA 的 Puppeteer + CaptchaAI 进阶模式

Bright Data + CaptchaAI：完整的代理集成指南

CAPTCHA 供应商如何检测自动化（QA 编辑视角）

使用验证码解决进行学术研究网络抓取

要求

它是如何运作的

第 1 步：创建求解器模块

第 2 步：设置 Puppeteer (默认配置)功能

步骤 3：解决页面上的 reCAPTCHA 问题

第 4 步：处理回调

完整的工作示例

故障排除

常问问题

我应该使用无头模式还是有头模式？

我可以将 Puppeteer 与 Cloudflare Turnstile 一起使用吗？

如何在一页上处理多个验证码？

相关指南

相关文章

使用 Node.js 进行验证码抓取：完整教程

Puppeteer + CaptchaAI 用于自有浏览器流程的 QA 测试

面向自有 QA 的 Puppeteer + CaptchaAI 进阶模式

Bright Data + CaptchaAI：完整的代理集成指南

CAPTCHA 供应商如何检测自动化（QA 编辑视角）

使用验证码解决进行学术研究网络抓取