跳转到主要内容
获取令牌时遇到问题吗
联系支持

reCAPTCHA v2

查看全部价格

该对象包含 Google reCAPTCHA v2 解决任务的数据。为确保解决此类验证码的普遍性，您需要使用在自动填写目标网站表单时使用的所有数据，包括代理、浏览器用户代理和 cookies。这将有助于避免在 Google 更改其验证码代码时出现任何问题。

相比于普通的图像验证码，此类验证码可能需要更长时间来解决，但通过我们发送给您的 g-recaptcha-response 值，在解决您的 reCAPTCHA v2 后的下一个 60 秒内仍然有效，可以弥补这一问题。

更多相关内容，请访问我们的博客
注意！

默认情况下，CapMonster Cloud 使用内置代理，适用于大多数网站。
但是，如果目标网站不接受令牌，请尝试使用自定义代理（使用代理的 RecaptchaV2Task）。在解决验证码和提交令牌到网站时，请确保使用相同的代理。

  • 如果使用基于 IP 的授权，请将 65.21.190.34 添加到白名单。

  • 如果 reCAPTCHA v2 令牌仍无法被接受，请联系技术支持。

对象结构​

type<string>required

RecaptchaV2Task

websiteURL<string>required

带有验证码的网页地址。

websiteKey<string>required

ReCaptcha 网站密钥。
<div class="g-recaptcha" data-sitekey="THIS_ONE"></div>

recaptchaDataSValue<string>optional

某些自定义实现可能包含 ReCaptcha2 div 中的额外 "data-s" 参数，实际上是一次性令牌，每次解决 ReCaptcha2 都必须获取。
<div class="g-recaptcha" data-sitekey="some sitekey" data-s="THIS_ONE"></div>

userAgent<string>optional

用于仿真的浏览器用户代理。必须使用现代浏览器的签名，否则 Google 将要求您 "更新您的浏览器"。

cookies<string>optional

额外的 Cookie，我们在与目标页面或谷歌的交互过程中必须使用

格式：cookiename1=cookievalue1; cookiename2=cookievalue2

isInvisible<bool>optional

"true" 如果验证码是隐形的，即没有确认复选框，而是有一个隐藏字段。如果怀疑是机器人，则进行额外检查。

proxyType<string>optional

http - 普通的 http/https 代理；
https - 仅在 "http" 不起作用时尝试（某些自定义代理服务器要求）；
socks4 - socks4 代理；
socks5 - socks5 代理。

proxyAddress<string>optional

代理 IP 地址 IPv4/IPv6。不允许：

  • 使用透明代理（其中客户端 IP 可见）；
  • 使用来自本地网络的代理。

proxyPort<integer>optional

代理端口。

proxyLogin<string>optional

代理登录。

proxyPassword<string>optional

代理密码。

创建任务方法​

POST
https://api.capmonster.cloud/createTask

要求

{
  "clientKey":"API_KEY",
  "task": {
	"type":"RecaptchaV2Task",
	"websiteURL":"https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
	"websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  }
}

回应

{
  "errorId":0,
  "taskId":407533072
}

获取任务结果方法​

警告！

在某些网站上，确保 UserAgent 与解决验证码时使用的 UserAgent 相匹配非常重要。因此，如果 CapMonster Cloud 在返回令牌的同时提供了 UserAgent，请始终在提交表单或在目标页面确认解决方案时使用该 UserAgent。

使用getTaskResult方法请求 ReCaptcha2 的答案。根据服务工作负载，您将在 100 毫秒内收到响应。

POST
https://api.capmonster.cloud/getTaskResult

要求

{
  "clientKey":"API_KEY",
  "taskId": 407533072
}

回应

{
  "errorId":0,
  "status":"ready",
  "solution": {
	"gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
  }
}

对于某些网站，响应可能如下所示。提交解决方案时，请确保使用响应中提供的 UserAgent，即使它与您当前使用的浏览器或脚本不同。

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36",
    "gRecaptchaResponse": "0cAFcWeA5Y3...hF8UWA",
    "cookies": {
      "nocookies": "true"
    }
  }
}

属性类型描述
gRecaptchaResponseString应插入到 Recaptcha2 提交表单中的哈希值，格式如 <textarea id="g-recaptcha-response" ..></textarea>。长度为500到2190字节。

如何查找任务创建所需的所有参数​

手动方式​

  1. 请在浏览器中访问您的网站，该网站包含验证码功能。
  2. 右键点击验证码元素，选择 检查（Inspect）。

websiteKey（data-sitekey）​

在 Elements（元素） 标签页中：查找页面上的 <div class="g-recaptcha"> 元素。复制其 data-sitekey 属性的值，例如：

sitekey

在 Network（网络） 标签页：

打开 Network 标签页并重新加载包含验证码的页面。查找如下请求（k 值即为 data-sitekey）：

sitekey1

recaptchaDataSValue（如果使用）​

如果页面包含 data-s 属性，在 HTML 中查找它：

datas

isInvisible（是否为隐形验证码）​

在 Network 标签页中：如果是隐形验证码，元素将包含 size="invisible" 属性，例如：

isinvisible

自动方法​

为了自动化获取所需参数，可以通过 浏览器（普通模式或 headless 模式，例如使用 Playwright）进行提取，或直接从 HTTP 请求中获取。由于动态参数的有效时间较短，建议在获取后尽快使用。

重要

所提供的代码片段仅作为获取必要参数的基础示例。具体实现方式取决于包含验证码的网站、本身的页面结构，以及所使用的 HTML 元素和选择器。

显示代码（浏览器端）
(() => {
  const iframeEl = document.querySelector('iframe[src^="https://www.google.com/recaptcha/api2/anchor?"]');
  const captchaUrl = iframeEl?.getAttribute('src');

  if (captchaUrl) {
    const urlParams = new URLSearchParams(captchaUrl.split('?')[1]);
    
    const sitekey = urlParams.get('k');
    const size = urlParams.get('size');
    
    const isInvisible = size === 'invisible';

    const sitekeyEl = document.querySelector('[data-sitekey]');
    const datasEl = document.querySelector('[data-s]');
    const datas = datasEl?.getAttribute('data-s');

    console.log({
      sitekey: sitekey || sitekeyEl?.getAttribute('data-sitekey'),
      datas,
      isInvisible
    });
  }
})();
显示代码（Node.js）
import { chromium } from "playwright";

(async () => {
  const browser = await chromium.launch({ headless: false });
  const page = await browser.newPage();

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

  await page.waitForSelector('iframe[src^="https://www.google.com/recaptcha/api2/anchor?"]');

  const captchaData = await page.evaluate(() => {
    const iframeEl = document.querySelector('iframe[src^=
    "https://www.google.com/recaptcha/api2/anchor?"]');
    const captchaUrl = iframeEl?.getAttribute("src");

    if (captchaUrl) {
      const urlParams = new URLSearchParams(captchaUrl.split("?")[1]);
      const sitekey = urlParams.get("k");
      const size = urlParams.get("size");
      const isInvisible = size === "invisible";

      const sitekeyEl = document.querySelector("[data-sitekey]");
      const datasEl = document.querySelector("[data-s]");
      const datas = datasEl?.getAttribute("data-s");

      return {
        sitekey: sitekey || sitekeyEl?.getAttribute("data-sitekey"),
        datas,
        isInvisible,
      };
    }
    return null;
  });

  console.log(captchaData);
  await browser.close();
})();

使用 SDK 库​

显示代码（用于浏览器）
// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, RecaptchaV2Request } 
  from '@zennolab_com/capmonstercloud-client';

document.addEventListener('DOMContentLoaded', async () => {

  const API_KEY = "YOUR_API_KEY";  // 输入您的 CapMonster Cloud API 密钥

  const cmcClient = CapMonsterCloudClientFactory.Create(
    new ClientOptions({ clientKey: API_KEY })
  );

  // 如有必要，可以检查余额
  const balance = await cmcClient.getBalance();
  console.log("Balance:", balance);

  // 基本示例，无需代理
  // CapMonster Cloud 会自动使用它们的代理
  let recaptchaV2Request = new RecaptchaV2Request({
    websiteURL: "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
    websiteKey: "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  });

  // 使用您自己的代理的示例
  // 如果想使用自己的代理，请取消注释以下代码块

  /*
  const proxy = {
      proxyType: "http",
      proxyAddress: "123.45.67.89",
      proxyPort: 8080,
      proxyLogin: "username",
      proxyPassword: "password"
  };

  recaptchaV2Request = new RecaptchaV2Request({
      websiteURL: "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
      websiteKey: "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",
      proxy,
      userAgent: "userAgentPlaceholder"
  });
  */

  const result = await cmcClient.Solve(recaptchaV2Request);
  console.log("Solution:", result);
});
显示代码 (Node.js)
// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, RecaptchaV2Request } from '@zennolab_com/capmonstercloud-client';

const API_KEY = "YOUR_API_KEY";  // 输入您的 CapMonster Cloud API 密钥

async function solveRecaptchaV2() {
    const client = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: API_KEY })
    );

    // 基本示例，无需代理
    // CapMonster Cloud 会自动使用它们的代理
    let recaptcha2Request = new RecaptchaV2Request({
        websiteURL: "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
        websiteKey: "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
    });

    // 使用您自己的代理的示例
    // 如果想使用自己的代理，请取消注释以下代码块

    /*
    const proxy = {
        proxyType: "http",
        proxyAddress: "123.45.67.89",
        proxyPort: 8080,
        proxyLogin: "username",
        proxyPassword: "password"
    };

    recaptcha2Request = new RecaptchaV2Request({
        websiteURL: "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
        websiteKey: "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",
        proxy,
        userAgent: "userAgentPlaceholder"
    });
    */

    // 如有必要，可以检查余额
    const balance = await client.getBalance();
    console.log("Balance:", balance);

    const result = await client.Solve(recaptcha2Request);
    console.log("Solution:", result);
}

solveRecaptchaV2().catch(console.error);
更多相关内容，请访问我们的博客
这篇文章有帮助吗？
查看 AI CAPTCHA 求解器的价格