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

Friendly Captcha

查看全部价格

注意！

CapMonster Cloud 默认通过内置代理工作——这些代理已包含在费用内。仅当网站不接受令牌或对内置服务的访问受限时，才需要指定您自己的代理。

如果代理按 IP 授权，请将地址 65.21.190.34 加入白名单。

请求参数​

type<string>required

CustomTask

class<string>required

friendly

websiteURL<string>required

包含验证码的页面完整 URL。

websiteKey<string>required

Friendly Captcha 密钥（参见如何查找 sitekey 的值章节）。
大致格式如下：FFMGEMAD2K3JJ35P

apiGetLib（位于 metadata 中）<string>required

JS 文件链接。请根据验证码版本指定 JS 文件的 URL：

  • V1： apiGetLib = https://cdn.jsdelivr.net/npm/[email protected]/widget.module.min.js，其中 X.Y.Z 是 x-frc-client 请求头中的客户端版本。

  • V2： apiGetLib = 页面加载的 site.min.js 文件 URL。示例：https://cdn.jsdelivr.net/npm/@friendlycaptcha/[email protected]/site.min.js，其中 X.Y.Z 是客户端版本。

详情请参阅创建任务的方法和如何确定 Friendly Captcha 版本章节。

userAgent<string>optional

浏览器 User-Agent。请使用 CapMonster Cloud 当前支持的值：userAgentPlaceholder

可通过以下地址获取最新值：https://capmonster.cloud/api/useragent/actual。

proxyType<string>required

http - 常规 HTTP/HTTPS 代理；
https - 当 http 不可用时使用（某些自定义代理必填）；
socks4 - SOCKS4 代理；
socks5 - SOCKS5 代理。

proxyAddress<string>required

代理 IP 地址（IPv4/IPv6）。禁止使用：

  • 透明代理
  • 本地机器代理

proxyPort<integer>required

代理端口

proxyLogin<string>required

代理登录名

proxyPassword<string>required

代理密码

创建任务方法​

请在 metadata 中使用与 Friendly Captcha 版本对应的 apiGetLib 参数值。

例如：

对于 V1

  "apiGetLib": "https://cdn.jsdelivr.net/npm/[email protected]/widget.module.min.js"

对于 V2

  "apiGetLib": "https://cdn.jsdelivr.net/npm/@friendlycaptcha/[email protected]/site.min.js"

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

请求示例

{
  "clientKey": "API_KEY",
  "task": {
    "type": "CustomTask",
    "class": "friendly",
    "websiteKey": "your-website-key",
    "websiteURL": "https://yourwebsite.com/page-with-captcha",
    "userAgent": "userAgentPlaceholder",
    "metadata": {
  	"apiGetLib":"https://cdn.example.com/package/widget.module.min.js"
  }
}

响应示例

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

获取任务结果方法​

使用 getTaskResult 方法获取 Friendly Captcha 的解决结果。
响应中的令牌格式取决于网站上使用的验证码版本：

V1: "56a3727f1f9ae4f339c8e512913cd6f8.ac7W...MAKgAAAN+MAQArAAAAjxMBACwAAAB5QgAA.AgAB"

V2: "AQQA.8Q2TbgK_..._pknXDweJjKT2qwmroOhHcZsU4dHyu-jaGIPx9k7432p_num13buuTu6n4lVA=="

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

请求示例

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

响应示例

{
  "errorId": 0,
  "errorCode": null,
  "errorDescription": null,
  "status": "ready",
  "solution": {
    "data": {
      "token": "56a3727f1f9ae4f339c8e512913cd6f8.ac7W...MAKgAAAN+MAQArAAAAjxMBACwAAAB5QgAA.AgAB"
    }
  }
}

获取到的 token 值需要填入对应字段：

版本token 填充值字段
V1input.frc-captcha-solution
V2input.frc-captcha-response

如何查找 sitekey 值​

  • 对于 V1，可以在网络请求中通过关键词 sitekey 或 puzzle?sitekey= 进行过滤查找：

  • 对于 V2，可以在网络请求或页面代码元素中搜索关键词 sitekey 或 data-sitekey：

如何识别 Friendly Captcha 版本​

Friendly Captcha 主要有两种版本：V1 和 V2。 可以通过加载的脚本或网络请求来判断版本。

Friendly Captcha V1​

如果页面中存在以下脚本，则使用 V1：

widget.min.js
widget.module.min.js

或在网络请求中出现 puzzle?sitekey=：

要确定客户端版本，需要：

  1. 打开找到的 puzzle?sitekey=... 请求，并进入 Headers → Request Headers

  2. 查找 x-frc-client 请求头：

该请求头包含网站使用的 Friendly Captcha 客户端版本：

x-frc-client: <version>

示例值：0.9.14, 0.9.19 等。

  1. 确定 x-frc-client 版本后，将其填入 CDN 链接：
https://cdn.jsdelivr.net/npm/friendly-challenge@<VERSION>/widget.module.min.js

例如，如果 x-frc-client = 0.9.14，则使用：

https://cdn.jsdelivr.net/npm/[email protected]/widget.module.min.js

该链接需要在创建任务时传入 apiGetLib 参数。

Friendly Captcha V2​

如果网站加载了 site.min.js，则表示使用的是 Friendly Captcha V2。

在创建任务时，将 site.min.js 的链接传入 apiGetLib 参数：

Friendly Captcha 版本自动识别​

您可以在浏览器中使用以下方案来自动化识别 Friendly Captcha 的版本：

显示代码
(async function detectFriendlyCaptcha() {
  const result = {
    version: null,      
    clientVersion: null,
    indicators: [],
    siteMinJsLinks: [],
    detectedCdn: null
  };

  const scripts = Array.from(document.scripts).map(s => s.src);

  for (const src of scripts) {
    if (!src) continue;

    if (src.includes("widget.min.js") || src.includes("widget.module.min.js")) {
      result.version = "V1";
      result.detectedCdn = src;
      result.indicators.push("Found widget script");
    }

    const match = src.match(/friendly-challenge@(\d+\.\d+\.\d+)/);
    if (match) {
      result.clientVersion = match[1];
      result.version = "V1";
      result.detectedCdn = src;
      result.indicators.push("Detected CDN version");
    }
  }

  const puzzleElements = document.querySelectorAll(
    '[id*="friendly"], [class*="frc"], iframe[src*="friendly"]'
  );

  if (puzzleElements.length > 0) {
    result.indicators.push("Found captcha DOM elements");
    if (!result.version) result.version = "V1";
  }

  const resources = performance.getEntriesByType("resource");

  for (const r of resources) {
    if (r.name.includes("puzzle?sitekey")) {
      result.version = "V1";
      result.indicators.push("Found puzzle?sitekey request");
    }
  }

  for (const src of scripts) {
    if (!src) continue;

    if (src.includes("site.min.js")) {
      result.version = "V2";
      result.detectedCdn = src;
      result.indicators.push("Found site.min.js");
      result.siteMinJsLinks.push(src);
    }
  }

  if (!result.version) {
    result.version = "Unknown (not detected)";
  }

  console.log("FriendlyCaptcha Detection Result:");
  console.log(result);

  return result;
})();

使用 SDK 库​

显示代码（浏览器）
// https://github.com/CapMonsterCloud/capmonster-nodejs-captcha-solver

import {
  CapMonsterCloudClientFactory,
  ClientOptions,
  FriendlyRequest
} from "@zennolab_com/capmonstercloud-client";

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

  const API_KEY = "YOUR_API_KEY"; // 请填写您的 CapMonster Cloud API 密钥

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

  // 不使用代理的基础示例
  // CapMonster Cloud 会自动使用自己的代理
  let friendlyRequest = new FriendlyRequest({
    websiteURL: "https://yourwebsite.com/page-with-friendly-captcha",
    websiteKey: "your-website-key",
    userAgent: "userAgentPlaceholder",
    metadata: {
      apiGetLib: "your-api-get-lib-url",
    },
  });

  // 使用您自己的代理的示例
  // 如果您想使用自己的代理，请取消下面代码块的注释
  /*
  const proxy = {
    proxyType: "http",
    proxyAddress: "123.45.67.89",
    proxyPort: 8080,
    proxyLogin: "username",
    proxyPassword: "password",
  };

  friendlyRequest = new FriendlyRequest({
    websiteURL: "https://yourwebsite.com/page-with-friendly-captcha",
    websiteKey: "your-website-key",
    userAgent: "userAgentPlaceholder",
    metadata: {
      apiGetLib: "your-api-get-lib-url",
    },
    proxy,
  });
  */

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

  const result = await client.Solve(friendlyRequest);
  console.log("Solution:", result.solution);
});
显示代码（Node.js）
// https://github.com/CapMonsterCloud/capmonster-nodejs-captcha-solver

const {
  CapMonsterCloudClientFactory,
  ClientOptions,
  FriendlyRequest,
} = require("@zennolab_com/capmonstercloud-client");

const API_KEY = "YOUR_API_KEY"; // 请填写您的 CapMonster Cloud API 密钥

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

  // 不使用代理的基础示例
  // CapMonster Cloud 会自动使用自己的代理
  let friendlyRequest = new FriendlyRequest({
    websiteURL: "https://yourwebsite.com/page-with-friendly-captcha",
    websiteKey: "your-website-key",
    userAgent: "userAgentPlaceholder",
    metadata: {
      apiGetLib: "your-api-get-lib-url",
    },
  });

  // 使用您自己的代理的示例
  // 如果您想使用自己的代理，请取消下面代码块的注释
  /*
  const proxy = {
    proxyType: "http",
    proxyAddress: "123.45.67.89",
    proxyPort: 8080,
    proxyLogin: "username",
    proxyPassword: "password",
  };

  friendlyRequest = new FriendlyRequest({
    websiteURL: "https://yourwebsite.com/page-with-friendly-captcha",
    websiteKey: "your-website-key",
    userAgent: "userAgentPlaceholder",
    metadata: {
      apiGetLib: "your-api-get-lib-url",
    },
    proxy,
  });
  */

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

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

solveFriendlyCaptcha().catch(console.error);
这篇文章有帮助吗？
查看 AI CAPTCHA 求解器的价格