# @2captcha/captcha-solver 中文文档

规范地址：https://npmcn.com/package/%402captcha/captcha-solver/

版本：1\.4\.0
npm 元数据更新时间：2026-10-22T14:46:58.075Z
中文译文更新时间：2026-11-05T17:51:48.943Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%402captcha/captcha-solver
原文对照：https://npmcn.com/package/%402captcha/captcha-solver/?lang=original
项目主页：https://github.com/2captcha/2captcha-javascript
源码仓库：https://github.com/2captcha/2captcha-javascript

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：282 kB，35 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2024-03-29T13:59:43.880Z
- 最新版本发布：2026-10-20T11:01:14.863Z
- 近 30 天下载量：131311（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 10 个）

## 中文简介

JavaScript库与2captcha Captcha解析服务的API方便地集成,以绕过 reCAPTCHA, funcaptcha, geetest 并解决任何其他captcha.

## 安装

```sh
npm install @2captcha/captcha-solver
```

也可以使用：`pnpm add @2captcha/captcha-solver`、`yarn add @2captcha/captcha-solver`、`bun add @2captcha/captcha-solver`

## README

[![](https://github.com/user-attachments/assets/37e1d860-033b-4cf3-a158-468fc6b4debc)](https://github.com/2captcha/2captcha-python) [![](https://github.com/user-attachments/assets/371b271e-33c3-4217-af21-b95517a4677c)](https://github.com/2captcha/2captcha-javascript) [![](https://github.com/user-attachments/assets/ab22182e-6cb2-41fa-91f4-d5e89c6d7c6f)](https://github.com/2captcha/2captcha-go) [![](https://github.com/user-attachments/assets/0270d56f-79b0-4c95-9b09-4de89579914b)](https://github.com/2captcha/2captcha-ruby) [![](https://github.com/user-attachments/assets/36de8512-acfd-44fb-bb1f-b7c793a3f926)](https://github.com/2captcha/2captcha-cpp) [![](https://github.com/user-attachments/assets/e8797843-3f61-4fa9-a155-ab0b21fb3858)](https://github.com/2captcha/2captcha-php) [![](https://github.com/user-attachments/assets/a3d923f6-4fec-4c07-ac50-e20da6370911)](https://github.com/2captcha/2captcha-java) [![](https://github.com/user-attachments/assets/f4d449de-780b-49ed-bb0a-b70c82ec4b32)](https://github.com/2captcha/2captcha-csharp)

# 2 Captcha API (captcha 解析器) 的 JavaScript 模块

快速整合最简单的方式 [2 Captcha (英语)](https://2captcha.com/) 自动解析任何类型的解析 . 关于不同类型的API请求的实例,请访问 [JavaScript Captcha 解析器](https://2captcha.com/lang/javascript) 页 次.

-   [2 Captcha API (captcha 解析器) 的 JavaScript 模块](https://npmcn.com/package/%402captcha/captcha-solver/#readme-javascript-module-for-2captcha-api-captcha-solver)
    -   [安装](https://npmcn.com/package/%402captcha/captcha-solver/#readme-installation)
    -   [配置](https://npmcn.com/package/%402captcha/captcha-solver/#readme-configuration)
        -   [2 Captcha 实例选项](https://npmcn.com/package/%402captcha/captcha-solver/#readme-twocaptcha-instance-options)
    -   [解决卡布查](https://npmcn.com/package/%402captcha/captcha-solver/#readme-solve-captcha)
        -   [图像 Captcha](https://npmcn.com/package/%402captcha/captcha-solver/#readme-image-captcha)
        -   [(原始内容存档于2019-09-21) (英语). reCAPTCHA v2](https://npmcn.com/package/%402captcha/captcha-solver/#readme-recaptcha-v2)
        -   [reCAPTCHA v3 (英语)](https://npmcn.com/package/%402captcha/captcha-solver/#readme-recaptcha-v3)
        -   [乐趣卡普查](https://npmcn.com/package/%402captcha/captcha-solver/#readme-funcaptcha)
        -   [吉试](https://npmcn.com/package/%402captcha/captcha-solver/#readme-geetest-captcha)
        -   [GeeTest V4 测试V4](https://npmcn.com/package/%402captcha/captcha-solver/#readme-geetest-v4-captcha)
        -   [Yandex 智能卡普查](https://npmcn.com/package/%402captcha/captcha-solver/#readme-yandex-smart-captcha)
        -   [勒明已裁剪 Captcha](https://npmcn.com/package/%402captcha/captcha-solver/#readme-lemin-cropped-captcha)
        -   [云花花转弯](https://npmcn.com/package/%402captcha/captcha-solver/#readme-cloudflare-turnstile)
        -   [亚马逊WAF](https://npmcn.com/package/%402captcha/captcha-solver/#readme-amazon-waf)
        -   [队长](https://npmcn.com/package/%402captcha/captcha-solver/#readme-capy)
        -   [点击 Captcha](https://npmcn.com/package/%402captcha/captcha-solver/#readme-clickcaptcha)
        -   [数据Dome CAPTCHA](https://npmcn.com/package/%402captcha/captcha-solver/#readme-datadome-captcha)
        -   [网络西阿拉](https://npmcn.com/package/%402captcha/captcha-solver/#readme-cybersiara)
        -   [MTCAPTCHA 数据](https://npmcn.com/package/%402captcha/captcha-solver/#readme-mtcaptcha)
        -   [友好的卡普查语Name](https://npmcn.com/package/%402captcha/captcha-solver/#readme-friendly-captcha)
        -   [边框方法](https://npmcn.com/package/%402captcha/captcha-solver/#readme-bounding-box-method)
        -   [网格](https://npmcn.com/package/%402captcha/captcha-solver/#readme-grid)
        -   [文本 Captcha](https://npmcn.com/package/%402captcha/captcha-solver/#readme-text-captcha)
        -   [帆布](https://npmcn.com/package/%402captcha/captcha-solver/#readme-canvas)
        -   [旋转](https://npmcn.com/package/%402captcha/captcha-solver/#readme-rotate)
        -   [密钥卡普查](https://npmcn.com/package/%402captcha/captcha-solver/#readme-keycaptcha)
        -   [剪接点](https://npmcn.com/package/%402captcha/captcha-solver/#readme-cutcaptcha)
        -   [百分点](https://npmcn.com/package/%402captcha/captcha-solver/#readme-tencent)
        -   [美国](https://npmcn.com/package/%402captcha/captcha-solver/#readme-atbcaptcha)
        -   [Prosopo 软件](https://npmcn.com/package/%402captcha/captcha-solver/#readme-prosopo)
        -   [Captcha 福克斯语Name](https://npmcn.com/package/%402captcha/captcha-solver/#readme-captchafox)
        -   [图像](https://npmcn.com/package/%402captcha/captcha-solver/#readme-vkimage)
        -   [VkCaptcha 数据](https://npmcn.com/package/%402captcha/captcha-solver/#readme-vkcaptcha)
        -   [铁木儿](https://npmcn.com/package/%402captcha/captcha-solver/#readme-temu)
        -   [阿尔察](https://npmcn.com/package/%402captcha/captcha-solver/#readme-altcha)
        -   [二进制](https://npmcn.com/package/%402captcha/captcha-solver/#readme-binance)
        -   [音频 Captcha](https://npmcn.com/package/%402captcha/captcha-solver/#readme-audio-captcha)
        -   [义通 NECAPTCHA](https://npmcn.com/package/%402captcha/captcha-solver/#readme-yidun-necaptcha)
        -   [阿里巴巴·卡普察](https://npmcn.com/package/%402captcha/captcha-solver/#readme-alibaba-captcha)
        -   [技术秘书处](https://npmcn.com/package/%402captcha/captcha-solver/#readme-tspd)
        -   [巴西语Name](https://npmcn.com/package/%402captcha/captcha-solver/#readme-basilisk)
        -   [韩特](https://npmcn.com/package/%402captcha/captcha-solver/#readme-hunt)
        -   [拖放](https://npmcn.com/package/%402captcha/captcha-solver/#readme-drag-and-drop)
        -   [Imperva (Incapsula) (英语)](https://npmcn.com/package/%402captcha/captcha-solver/#readme-imperva-incapsula)
    -   [其他方法](https://npmcn.com/package/%402captcha/captcha-solver/#readme-other-methods)
        -   [良好报告](https://npmcn.com/package/%402captcha/captcha-solver/#readme-goodreport)
        -   [坏报](https://npmcn.com/package/%402captcha/captcha-solver/#readme-badreport)
        -   [余额](https://npmcn.com/package/%402captcha/captcha-solver/#readme-balance)
    -   [代理](https://npmcn.com/package/%402captcha/captcha-solver/#readme-proxies)
    -   [实例](https://npmcn.com/package/%402captcha/captcha-solver/#readme-examples)
    -   [使用 Pippeteer 的实例](https://npmcn.com/package/%402captcha/captcha-solver/#readme-examples-using-puppeteer)
-   [有用文章](https://npmcn.com/package/%402captcha/captcha-solver/#readme-useful-articles)
-   [保持联系](https://npmcn.com/package/%402captcha/captcha-solver/#readme-get-in-touch)
-   [加入球队](https://npmcn.com/package/%402captcha/captcha-solver/#readme-join-the-team-)
-   [许可证](https://npmcn.com/package/%402captcha/captcha-solver/#readme-license)
    -   [图形和商标](https://npmcn.com/package/%402captcha/captcha-solver/#readme-graphics-and-trademarks)

## 安装

该软件包可安装在国家预防机制:

```sh
npm install @2captcha/captcha-solver
```

或亚恩 :

```sh
yarn add @2captcha/captcha-solver
```

## 配置

可以这样创建两个 Captcha 实例 :

```js
const TwoCaptcha = require("@2captcha/captcha-solver")
const solver = new TwoCaptcha.Solver("<Your 2captcha api key>")
```

此外,还可以配置几个选项:

```javascript
const apiKey = 'YOUR_API_KEY'
const pollingInterval = 10

const solver = new TwoCaptcha.Solver(apiKey, pollingInterval)
```

### 2 Captcha 实例选项

| 选项 | 默认值 | 说明 |
| --- | --- | --- |
| 键 | \- 说吧 | 您的 API 键 |
| 投票 间隔 | 5000块 | 请求与 `res.php` API端点. 不建议设定小于5秒的值 |

## 解决卡布查

当提交任何基于图像的cabtcha使用时,可以提供额外选项来帮助2cabtcha工人正确解决.

### Captcha 选项

| 选项 | 默认值 | 说明 |
| --- | --- | --- |
| 数字 | 0 个 | 定义cabtcha是否包含数字符号或其他符号 [在 API 文档中看到更多信息](https://2captcha.com/2captcha-api#normal_post) |
| 分钟 | 0 个 | 最小答题长度 |
| 最大值( l) | 0 个 | 最大答题长度 |
| 语句 | 0 个 | 定义答案是否包含多个单词 |
| 备忘 | 0 个 | 定义答案是否对大小写敏感 |
| 计算 | 0 个 | 定义 captcha 需要计算 |
| 朗语 | \- 说吧 | 定义 captcha 语言; 参见 [支持语言列表](https://2captcha.com/2captcha-api#language) |
| 文本指令 | \- 说吧 | 向带 captcha 的工人显示提示或任务文本 |

下面可以找到每个 Captcha 类型的基本示例,查看下面的代码.

### 图像卡布查

[API方法描述.](https://2captcha.com/2captcha-api#solving_normal_captcha)

要绕过普通的cabtcha(被扭曲的图像上文字),使用以下方法. 这种方法也可以用来识别图像中的任何文本.

```js
const imageBase64 = fs.readFileSync("./examples/media/imageCaptcha_6e584.png", "base64")

solver.imageCaptcha({
    body: imageBase64,
    numeric: 4,
    min_len: 5,
    max_len: 5
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### 重击V2

[API方法描述.](https://2captcha.com/2captcha-api#solving_recaptchav2_new)

使用以下方法来解析reCAPTCHA V2并获得绕行保护的符号.

```js
solver.recaptcha({
  pageurl: 'https://2captcha.com/demo/recaptcha-v2',
  googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### 重击V3

[API方法描述.](https://2captcha.com/2captcha-api#solving_recaptchav3)

这种方法提供了一个 reCAPTCHA V3 解析器并返回一个符号.

```js
solver.recaptcha({
    pageurl: 'https://2captcha.com/demo/recaptcha-v3',
    googlekey: '6Lcyqq8oAAAAAJE7eVJ3aZp_hnJcI6LgGdYD8lge',
    version: "v3",
    min_score: "0.4",
    action: 'demo_action'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### 乐趣卡普查

[API方法描述.](https://2captcha.com/2captcha-api#solving_funcaptcha_new)

Fun Captcha (Arkoselabs) 解析方法. 返回一个符号 .

```js
solver.funCaptcha({
  pageurl: "https://funcaptcha.com/tile-game-lite-mode/fc/api/nojs/?pkey=804380F4-6844-FFA1-ED4E-5877CA1F1EA4&lang=en",
  publickey: "804380F4-6844-FFA1-ED4E-5877CA1F1EA4"
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### 吉特·卡普查(英语:Gee Test Captcha)

[API方法描述.](https://2captcha.com/2captcha-api#solving_geetest)

解决Gee Test 谜题的方法 Captcha. 返回一组符号为 JSON .

```js
// Read more about `challenge` on the page https://2captcha.com/p/geetest
solver.geetest({ 
  pageurl: 'https://2captcha.com/demo/geetest',
  gt: '81388ea1fc187e0c335c0a8907ff2625',
  challenge: '<you need to get a new challenge value each time>'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### Gee Test V4 Captcha (英语)

[API方法描述.](https://2captcha.com/2captcha-api#geetest-v4)

使用这种方法解决 Gee Test v4. 返回 JSON 中的响应.

```js
solver.geetestV4({
  pageurl: 'https://2captcha.com/demo/geetest-v4',
  captcha_id: 'e392e1d7fd421dc63325744d5a2b9c73'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### Yandex 智能卡普查

使用这种方法解决了Yandex Smart Captcha并获得一个绕行保护的符号.

```js
solver.yandexSmart({ 
  pageurl: "https://captcha-api.yandex.ru/demo",
  sitekey: "FEXfAbHQsToo97VidNVk3j4dC74nGW1DgdxjtNB9"
 })
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### 勒明已裁剪 Captcha

[API方法描述.](https://2captcha.com/2captcha-api#lemin)

使用这种方法解决了勒明并获得一个符号来绕过保护.

```js
solver.lemin({
  pageurl:'https://2captcha.com/demo/lemin', 
  captcha_id: 'CROPPED_3dfdd5c_d1872b526b794d83ba3b365eb15a200b',
  div_id: 'lemin-cropped-captcha',
  api_server: 'api.leminnow.com'
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### 云花花转弯

[API方法描述.](https://2captcha.com/2captcha-api#turnstile)

使用这种方法解决 Cloudflare Turnstile. 以符号返回 JSON .

Turnstile Captcha有两种类型,其中一种是Cloudflare Turnstile挑战页. 对于Turnstile Challenge的页面案例,我们有一个 [演示](https://github.com/2captcha/cloudflare-demo)。试试这个 [演示](https://github.com/2captcha/cloudflare-demo) 如果您需要解决 Cloudflare Turnstile 挑战页面 captcha.

```js
solver.cloudflareTurnstile({
    pageurl: "https://app.nodecraft.com/login",
    sitekey: "0x4AAAAAAAAkg0s3VIOD10y4"    
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

### 亚马逊WAF

[API方法描述.](https://2captcha.com/2captcha-api#amazon-waf)

使用这种方法解决亚马逊WAF Captcha也叫AWS WAF Captcha,是亚马逊AWS智能威胁缓解的一部分. 以符号返回 JSON .

```js
//INFO: The `context` value is dynamic, it is necessary to take the actual value from the page each time.
solver.amazonWaf({
  pageurl: "https://non-existent-example.execute-api.us-east-1.amazonaws.com/latest",
  sitekey: "AQIDAHjcYu/GjX+QlghicBgQ/7bFaQZ+m5FKCMDnO+vTbNg96AHMDLodoefdvyOnsHMRt...",
  context: "9BUgmlm48F92WUoqv97a49ZuEJJ50TCk9MVr3C7WMtQ0X6flVbufM4n8mjFLmbLVAPgaQ...",
  iv: "CgAHbCe2GgAAAAAj",
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### 队长

[API方法描述.](https://2captcha.com/2captcha-api#solving_capy)

基于托肯的方法来绕过 Capy 拼图 Captcha.

```js
solver.capyPuzzle({
    pageurl: "https://www.capy.me/account/register/",
    captchakey: "PUZZLE_Cme4hZLjuZRMYC3uh14C52D3uNms5w"
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

### 数据Dome CAPTCHA

[API方法描述.](https://2captcha.com/2captcha-api#datadome)

使用这种方法来解析 DataDome并获得一个符号来绕过保护.

> \[大  
> 要解决 DataDome captcha, 您必须使用代理 。 建议使用 [住宅代办](https://2captcha.com/proxy/residential-proxies)。 。 。 .

```js
solver.dataDome({
    pageurl: "https://rendezvousparis.hermes.com/client/register",
    captcha_url: "https://geo.captcha-delivery.com/captcha/?initialCid=AHrlqAAAAAMAEuQtkf4k1c0ABZhYZA%3D%3D&hash=789361B674144528D0B7EE76B35826&cid=mY4z7GNmh7Nt1lAFwpbNHAOcWPhyPgjHD2K1Pm~Od1iEKYLUnK3t7N2ZGUj8OqDK65cnwJHtHwd~t902vlwpSBA5l4ZHbS1Qszv~jEuEUJNQ_jMAjar2Kj3kq20MRJYh&t=fe&referer=https%3A%2F%2Frendezvousparis.hermes.com%2Fclient%2Fregister&s=40119&e=67fef144ac1a54dbd7507776367d2f9d5e36ec3add17fa22f3cb881db8385838",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36",
    proxy: "login:password@1.2.3.4:8888", // The (Username : Password @ Address : Port) of our chosen proxy
    proxytype: "http" // The 'Type' of proxy, http, https, socks, ect.
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 网络西阿拉

[API方法描述.](https://2captcha.com/2captcha-api#cybersiara)

使用这种方法解决CyberSiARA,并获得一个符号来绕过保护.

```js
solver.cyberSiARA({
    pageurl: "https://www.cybersiara.com/book-a-demo",
    master_url_id: "OXR2LVNvCuXykkZbB8KZIfh162sNT8S2",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### MTCAPTCHA 数据

[API方法描述.](https://2captcha.com/2captcha-api#mtcaptcha)

使用这种方法解决MTCaptcha并获得一个符号来绕过保护.

```js
solver.mtCaptcha({
    pageurl: "https://service.mtcaptcha.com/mtcv1/demo/index.html",
    sitekey: "MTPublic-DemoKey9M"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 友好的卡普查语Name

[API方法描述.](https://2captcha.com/2captcha-api#friendly-captcha)

使用这种方法解决友好Captcha并获得一个符号来绕过保护.

> \[大  
> 要成功使用接收到的符号, 不应在页面上加载 Captcha 部件 。 要做到这一点, 您需要中止请求 `/friendlycaptcha/...module.min.js` 在页面上。 当 Captcha 部件已经在页面上加载时, 接收到的符号可能无法工作 .

```js
solver.friendlyCaptcha({
    pageurl: "https://geizhals.de/?liftban=1&from=/455973138?fsean=5901747021356",
    sitekey: "FCMST5VUMCBOCGQ9"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 点击 Captcha

[API方法描述.](https://2captcha.com/2captcha-api#coordinates)

ClickCaptcha方法返回Captcha图像上各点的坐标. 如果您需要点击图像中的特定点,可以使用.

```js
const imageBase64 = fs.readFileSync("./tests/media/coordinates.jpg", "base64")

solver.coordinates({
    body: imageBase64,
    textinstructions: 'Select all photos containing the boat'
 })
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

### 边框方法

[API方法描述.](https://2captcha.com/2captcha-api#bounding_box)

需要选择图像上的对象时使用 Bbounding Box 方法。 要做到这一点,就需要通过标记说明和标记图像. 指令可以作为文本发送,也可以作为编码在 `base64` 格式.

> \[大  
> 您必须发送指令 `imginstructions` 或者说 `textinstructions`。 。 。 .

```js
solver.boundingBox({ 
  image: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAR4AAACwCAIAAAB...",
  textinstructions: "Circle all the cars in the image.",
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

### 网格

[API方法描述.](https://2captcha.com/2captcha-api#grid)

这种方法可以解决任何可以将图像分为等分的部分如reCAPTCHA V2. 在图像上方应用网格。 你得到的数字点击了框.

> \[大  
> 您必须发送指令 `imginstructions` 或者说 `textinstructions`。 。 。 .

```js
solver.grid({ 
  body: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAR4AAACwCAIAAAB...",
  textinstructions: "Select cars in the image"
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

### 文本 Captcha

[API方法描述.](https://2captcha.com/2captcha-api#solving_text_captcha)

这种方法可用于绕过需要回答以清晰文本提供的问题的cabtcha.

```js
solver.textCaptcha({
  textcaptcha: "If tomorrow is Saturday, what day is today?",
  lang: 'en'
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

### 帆布

[API方法描述.](https://2captcha.com/2captcha-api#canvas)

画布方法可以用于在图像上需要围绕对象画出一行. 返回一组点'坐标来绘制多边形.

```js
solver.canvas({
    body: 'iVBORw0KGgoAAAANSgAAAcIA...',
    imginstructions: '/9j/4AAQSkZJRgABAQEA...',
    textinstructions: 'Highlight the red CIRCLE'
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

### 旋转

[API方法描述.](https://2captcha.com/2captcha-api#solving_rotatecaptcha)

这种方法可用于解决一个要求旋转对象的cabtcha. 它主要用于绕道FunCaptcha. 返回自转角度.

```js
solver.rotate({
  body: imageBase64,
  textinstructions: "Rotate the object to the correct position"
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

### 密钥卡普查

[API方法描述.](https://2captcha.com/2captcha-api#solving_keycaptcha)

基于token的解密方法 Captcha.

```js
solver.keyCaptcha({
    pageurl: "https://2captcha.com/demo/keycaptcha",
    userId: '184015',
    sessionId: '0917788cad24ad3a69813c4fcd556061',
    webServerSign: '02f7f9669f1269595c4c69bcd4a3c52e',
    webServerSign2: 'd888700f6f324ec0f32b44c32c50bde1'
})
.then((res) => {
    console.log(res);
})
.catch((err) => {
    console.log(err);
})
```

### 剪接点

[API方法描述.](https://2captcha.com/2captcha-api#cutcaptcha)

使用这种方法解决 Cutcaptcha. 返回 JSON 中的响应.

```js
solver.cutCaptcha({
    pageurl: "https://mysite.com/page/with/cutcaptcha",
    misery_key: "098e6a849af406142e3150dbf4e6d0538db2b51f", 
    api_key: "SAs61IAI",
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 百分点

[API方法描述.](https://2captcha.com/2captcha-api#tencent)

使用这种方法解决 Tencent Captcha. 返回 JSON 中的响应.

```js
solver.tencent({
    pageurl: "https://mysite.com/page/with/tencent",
    appId: "189956587"  
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 美国

[API方法描述.](https://2captcha.com/2captcha-api#atb-captcha)

使用这种方法解决AtbCAPTCHA的挑战. 返回一个绕过 Captcha 的符号 .

```js
solver.atbCaptcha({
    pageurl: "https://mysite.com/page/with/atbCAPTCHA",
    appId: "af25e409b33d722a95e56a230ff8771c",
    apiServer: "https://cap.aisecurius.com"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### Prosopo 软件

[API方法描述.](http://2captcha.com/2captcha-api#prosopo-procaptcha)

使用这种方法解决Prosopo,并获得一个符号来绕过保护.

```js
solver.prosopo({
    pageurl: "https://mysite.com/page/with/prosopo",
    sitekey: "5DWvYfCSGqbUiQ..."
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### Captcha 福克斯语Name

[API方法描述.](https://2captcha.com/2captcha-api#captchafox)

使用这种方法解决 CaptchaFox 并获得一个符号来绕过保护.

> \[大  
> 要解决 CaptchaFox, 您必须使用代理 。 建议使用 [住宅代办](https://2captcha.com/proxy/residential-proxies)。 。 。 .

```js
solver.captchaFox({
    pageurl: "https://mysite.com/page/with/captchafox",
    sitekey: "sk_ILKWN...",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit...",
    proxy: "login:password@1.2.3.4:8888", // The (Username : Password @ Address : Port) of our chosen proxy
    proxytype: "http" // The 'Type' of proxy, http, https, socks, ect.
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 图像

[API方法描述.](https://2captcha.com/2captcha-api#vkcaptcha)

这种方法可用于用图形化的captcha来解决VK captcha. 返回目标站点的 API 格式中的步骤数和解决方案值 .

```js
solver.vkimage({
    body: "iVBORw0KGgoAAAANSUhEUgAAAcIA...",
    steps: "[5,19,4,3,23,8,20,4,18,10,6,10,5,12,13,18,9,14,9,15,12,19,3,12,...]",
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### VkCaptcha 数据

[API方法描述.](https://2captcha.com/2captcha-api#vkcaptcha)

使用这种方法解决 Vk Captcha 并获得一个符号来绕过保护.

> \[大  
> 要解决 VkCaptcha , 您必须使用代理 。 建议使用 [住宅代办](https://2captcha.com/proxy/residential-proxies)。 。 。 .

```js
solver.vkcaptcha({
    redirect_uri: "https://id.vk.com/not_robot_captcha?domain=vk.com&session_token=eyJhbGciOiJBM...",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit...",
    proxy: "login:password@1.2.3.4:8888", // The (Username : Password @ Address : Port) of our chosen proxy
    proxytype: "http" // The 'Type' of proxy, http, https, socks, ect.
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 铁木儿

[API方法描述.](https://2captcha.com/ru/2captcha-api#temucaptcha)

这种方法可用于解决铁木儿卡普察. 返回坐标.

```js
solver.temu({
    body: "data:image/png;base64,iVBORw0KG...",
    part1: "data:image/png;base64,iVBORw0KG...",
    part2: "data:image/png;base64,iVBORw0KG...",
    part3: "data:image/png;base64,iVBORw0KG...",
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 阿尔察

[API方法描述.](https://2captcha.com/2captcha-api#altchacaptcha)

这种方法可用于解决Altcha Captcha. 返回一个符号 .

```js
solver.altcha({
    pageurl: "https://mysite.com/page/with/altcha",
    challenge_url: "https://example/altcha",
    challenge_json: '{"algorithm":"SHA-256","challenge":"a4c9d8e7f1b23a6c...",..."signature":"7b3e2a9d5c8f1046e2d91c3a..."}'
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 二进制

[API方法描述.](https://2captcha.com/2captcha-api#binance)

这种方法可用于解决 Binance Captcha. 返回一个符号 .

```js
solver.binance({
    pageurl: "https://mysite.com/page/with/binance",
    sitekey: "register",
    validateId: "0a05453c44e2411195c0d0c15654d966",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/113.0.0.0 Safari/537.36",
    proxy: "login:password@1.2.3.4:8888",
    proxytype: "HTTP"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 音频 Captcha

[API方法描述.](https://2captcha.com/2captcha-api#audio-recognition)

使用以下方法绕过音频 captcha(`mp3` 页:1 您必须提供语言作为 `lang = 'en'`所支持的语言有"en","ru","de","el","pt","fr"等.

```js
solver.audio({
  body: "SUQzBAAAAAAAHFRTU0UAAAA...",
  lang: "en"
})
.then((res) => {
  console.log(res);
})
.catch((err) => {
  console.log(err);
})
```

### 义通 NECAPTCHA

[API方法描述.](https://2captcha.com/2captcha-api#yidun)

这种方法可用于解决Yidun NECaptcha. 返回一个符号 .

```js
solver.yidun({
    pageurl: "https://mysite.com/page/with/yidun",
    sitekey: "your_site_key",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36",
    yidunGetLib: "https://cstaticdun.126.net/load.min.js",
    yidunApiServerSubdomain: "cstaticdun.126.net",
    challenge: "12345678abc90123d4567ef8a9012345",
    hcg: "your_hcg_value",
    hct: 1234567890,
    proxy: "login:password@1.2.3.4:8888",
    proxytype: "HTTP"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 阿里巴巴·卡普察

[API方法描述.](https://2captcha.com/2captcha-api#alibaba)

这种方法可用于解决阿里巴巴卡普查(英语:Aliyun). 返回一个符号 .

所需参数 : `pageurl`, (中文(简体) ), `sceneId`, (中文(简体) ), `prefix`。 。 。 .

```js
solver.alibaba({
    pageurl: "https://www.example.com",
    sceneId: "abc123xyz4",
    prefix: "dlw3kug",
    user_id: "Abc123Def456Ghi789Jkl012Mno345Pqr678Stu901=",
    user_user_id: "Xyz987Abc654Def321Ghi098Jkl765Mno432Pqr109=",
    verifyType: "1.0",
    region: "sgp",
    userCertifyId: "abc123def456ghi789jkl012mno345pq",
    apiGetLib: "https://o.example.com/captcha-frontend/aliyunCaptcha/AliyunCaptcha.js?t=2041",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 技术秘书处

[API方法描述.](https://2captcha.com/2captcha-api#tspd)

基于Cookie的自动解析TSPD Captcha的方法. 返回可用于访问目标页面的 cookie .

所需参数 : `pageurl`, (中文(简体) ), `tspdCookie`, (中文(简体) ), `htmlPageBase64`, (中文(简体) ), `proxy`, (中文(简体) ), `proxytype`。 。 。 .

**重要内容:** `tspdCookie` 财务报告和审定财务报表 `htmlPageBase64` 它们是动态的——在创建任务之前立即提取。 一个带有静态会话和同个IP的代理必须在所有阶段使用.

```js
solver.tspd({
    pageurl: "https://example.com/login",
    tspdCookie: "TS386a400d029=082670...010245; TS386a400d078=082670...dbb3b0c",
    htmlPageBase64: "PCFET0NUWVBFIGh0bWw+...",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
    proxy: "login:password@1.2.3.4:8080",
    proxytype: "HTTP"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 巴西语Name

[API方法描述.](https://2captcha.com/2captcha-api#basilisk)

这种方法可用于解决Basilisk Captcha. 返回一个符号 .

所需参数 : `pageurl`, (中文(简体) ), `sitekey`。 。 。 .

```js
solver.basilisk({
    pageurl: "https://example.com/login",
    sitekey: "b7890h...19fb2600897",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
    proxy: "login:password@1.2.3.4:8080",
    proxytype: "HTTP"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### 韩特

[API方法描述.](https://2captcha.com/2captcha-api#hunt)

这种方法可用于解决Hunt Captcha.

Hunt Captcha使用双步工作流程:

1.  不创建任务 `data` 获取 `X-HD` 数值.
2.  随收到的请求发送到目标站点 `X-HD` 头,得到 `meta.token`,然后创建第二个任务 `data` 以获得最终解决方案符号.

所需参数 : `pageurl`, (中文(简体) ), `apiGetLib`。 。 。 .

```js
// Step 1: get X-HD
solver.hunt({
    pageurl: "https://example.com/page-with-hunt",
    apiGetLib: "https://example.com/hd-api/external/apps/app-id/api.js",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
})
.then((res) => {
console.log(res.data); // X-HD
})
.catch((err) => {
console.log(err);
})

// Step 2: solve captcha with meta.token
solver.hunt({
    pageurl: "https://example.com/page-with-hunt",
    apiGetLib: "https://example.com/hd-api/external/apps/app-id/api.js",
    data: "META_TOKEN_VALUE",
    proxy: "login:password@1.2.3.4:8080",
    proxytype: "HTTP"
})
.then((res) => {
console.log(res.data); // solution token
})
.catch((err) => {
console.log(err);
})
```

### 拖放

[API方法描述.](https://2captcha.com/2captcha-api#drag-and-drop-captcha)

解决 Captcha 的方法, 其中需要将一个或多个图像拖入背景图像上的特定位置 .

所需参数 : `body`, (中文(简体) ), `images`。 。 。 .

结果是:`data`)是诸如坐标的管道分隔字符串 `"120,340|null|210,90"`的顺序 `images` 您发送的数组 . `null` 表示对应的图像没有被移动——它确实 **没有** 指错误或坐标 `(0,0)`。 。 。 .

```js
solver.dragAndDrop({
    body: "BASE64_BACKGROUND_IMAGE",
    images: ["BASE64_IMAGE_1", "BASE64_IMAGE_2"],
    textinstructions: "Drag the images to proper position"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

### Imperva (Incapsula) (英语)

[API方法描述.](https://2captcha.com/2captcha-api#imperva)

基于 Cookie 的 Imperva (Incapsula) Captcha 自动解析方法. 返回可用于访问目标页面的 cookie .

所需参数 : `pageurl`, (中文(简体) ), `incapsulaScriptUrl`, (中文(简体) ), `incapsulaCookies`, (中文(简体) ), `proxy`, (中文(简体) ), `proxytype`。 。 。 .

**重要内容:** 此 Captcha 类型需要一个代理 。 一些参数是动态生成的,可能与由Imperva(Incapsula)保护的页面的每个负载不同.

结果是:`data`)是一个对象。 饼干从 `data.domains` 必须传递到目标地点。 若为 `data.headers["User-Agent"]` 中,在向网站提出的请求中使用相同的用户代理.

```js
solver.imperva({
    pageurl: "https://example.com/login",
    incapsulaScriptUrl: "/_Incapsula_Resource?SWUDNSAI=31&xinfo=1",
    incapsulaCookies: "visid_incap_123456=sample; incap_ses_123_123456=sample",
    reese84UrlEndpoint: "https://example.com/_Incapsula_Resource?reese84=1",
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
    proxy: "login:password@1.2.3.4:8080",
    proxytype: "HTTP"
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
})
```

## 其他方法

### 良好报告

[API方法描述.](https://2captcha.com/2captcha-api#reporting-answers)

使用这种方法来报告良好的 Captcha 答案 .

```js
solver.goodReport('7031846604')
```

### 坏报

[API方法描述.](https://2captcha.com/2captcha-api#reporting-answers)

用这种方法来报告糟糕的 Captcha 回答 .

```js
solver.badReport('7031854546')
```

### 余额

[API方法描述.](https://2captcha.com/2captcha-api#additional-methods)

使用这种方法获取账户余额 .

```js
solver.balance()
.then((res) => {
    console.log(res)
})
```

## 代理

您可以通过您的代理作为方法的附加参数: recaptcha, funcaptcha, geetest, geetest v4, keycaptcha, capy 拼图, lemin, torntile, amazon waf, DataDome, CyberSiARA, MTCaptcha, 友好Captcha等. 代理将转发到API以解决cabtcha.

我们有我们自己的代理人可以给你. [购买住宅代理](https://2captcha.com/proxy/residential-proxies) 避免限制和障碍. [快开始](https://2captcha.com/proxy?openAddTrafficModal=true)。 。 。 .

通过代理解决 reCAPTCHA V2 :

```js
solver.recaptcha({
    pageurl: 'https://2captcha.com/demo/recaptcha-v2',
    googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u',
    proxy: 'HTTPS',
    proxytype: 'login:password@123.123.123.123:3128'
})
```

## 实例

解决所有支持的 Captcha 类型的例子位于 [实例](https://npmcn.com/package/%402captcha/captcha-solver/examples) 目录.

## 使用 Pippeteer 的实例

另外我们还有一个单独的寄存器 你们可以找到一些例子 用Puppeteer来解决 Captcha. 目前,我们实施了绕过Cloudflare挑战网页和reCAPTCHA的例子. 链接 :

-   [使用 Pippeteer 的 Cloudflare 绕行程序](https://github.com/2captcha/cloudflare-demo)
-   [使用 Puppeteer 并点击 来解决 reCAPTCHA V2](https://github.com/2captcha/puppeteer-recaptcha-solver-using-clicks)
-   [自定义滑块 Captcha Demo](https://github.com/2captcha/custom-slider-demo)

## 有用文章

-   [如何使用 JavaScript 绕行 Captcha](https://2captcha.com/blog/how-to-use-javascript-to-bypass-captcha#how-to-solve-and-bypass-a-captcha-with-javascript-using-npm-package-2captchacaptcha-solver)
-   [与普普特尔和2 Captcha一起通过Cloudflare挑战](https://2captcha.com/blog/bypassing-cloudflare-challenge-with-puppeteer-and-2captcha)
-   [如何绕过 Geetest v4 CAPTCHA](https://2captcha.com/blog/geetest-v4-support)
-   [自动 reCAPTCHA V3 分辨率 - 开发者和客户的教程](https://2captcha.com/blog/recaptcha-v3-automatic-resolution)

## 保持联系

[![](https://github.com/user-attachments/assets/539df209-7c85-4fa5-84b4-fc22ab93fac7)](mailto:support@2captcha.com) [![](https://github.com/user-attachments/assets/be044db5-2e67-46c6-8c81-04b78bd99650)](https://2captcha.com/support/tickets/new)

## 加入球队

有许多办法可以作出贡献,发展只是其中之一! 找到下一个工作。 开放职位:AI专家、刮刮机、开发者、技术支持

[![](https://github.com/user-attachments/assets/36d23ef5-7866-4841-8e17-261cc8a4e033)](mailto:job@2captcha.com)

## 许可证

这个寄存器中的代码根据麻省理工学院许可证获得许可. 见 [自由主义](https://npmcn.com/package/%402captcha/captcha-solver/LICENSE) 以备详细文件.

### 图形和商标

本寄存器中包含的图形和商标不受"麻省理工学院许可证"管辖. 请联系 [支助](mailto:support@2captcha.com) 允许使用这些材料.

## 常见问题

### @2captcha/captcha-solver 是什么？

JavaScript库与2captcha Captcha解析服务的API方便地集成,以绕过 reCAPTCHA, funcaptcha, geetest 并解决任何其他captcha\.

### 如何安装 @2captcha/captcha-solver？

在项目目录运行 npm install @2captcha/captcha-solver，或使用 pnpm add / yarn add / bun add。

### @2captcha/captcha-solver 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @2captcha/captcha-solver 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @2captcha/captcha-solver 可以商用吗？

@2captcha/captcha-solver 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @2captcha/captcha-solver 的下载量有多少？

根据 npm 官方下载统计，@2captcha/captcha-solver 在 2026/10/05 – 2026/11/03 这 30 天内被下载 131,311 次，日均约 4,377 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @2captcha/captcha-solver 还在维护吗？

最新版本 1\.4\.0 发布于 2026/10/20（18 天前）；至今共发布 19 个版本，其中过去 12 个月发布了 10 个；首次发布于 2024/03/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。