# 2captcha-wrapper

> A module to solve google's recaptcha v2 using the 2captcha service.

Latest version **1.1.1** (published 2020-02-08) · ISC license · 0 weekly downloads

## Install

```sh
npm install 2captcha-wrapper
pnpm add 2captcha-wrapper
yarn add 2captcha-wrapper
bun add 2captcha-wrapper
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.1 |
| Published | 2020-02-08 |
| First published | 2020-02-07 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 4.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | IcaroAugusto |
| Maintainers | icaroaugusto |
| Keywords | bypass, recaptcha, captcha, google, 2captcha |

## Links

- npm: https://www.npmjs.com/package/2captcha-wrapper
- Repository: https://github.com/IcaroAugusto/2captcha-wrapper
- Homepage: https://github.com/IcaroAugusto/2captcha-wrapper#readme
- Issues: https://github.com/IcaroAugusto/2captcha-wrapper/issues
- npm.io page: https://npm.io/package/2captcha-wrapper

## Recent versions

- 1.1.1 (latest) — 2020-02-08
- 1.1.0 — 2020-02-08
- 1.0.1 — 2020-02-07
- 1.0.0 — 2020-02-07

## README

# NODE.js 2captcha wrapper

This is a node.js module for solving google's recaptcha v2 using the 2captcha service.

## Installation

`npm install 2captcha-wrapper`

## Usage

You will need a 2captcha api key, which you can get [here](https://2captcha.com?from=7451288).

The module exports the TwoCaptcha prototype. It accepts two parameters on construction: apiKey and timeout, 
the timeout parameter can be ommited, defaulting to 180000 milliseconds;

The object contains the solve method that should be used to get the captcha id/token for google recaptcha.

The solve method, when successful, returns an object containing the request id and token. On failure it returns null and reports the
bad captcha.

After getting the token, you can send it with your http request or set it in the page if you're running puppeteer/selenium.

The id can be used to report good/bad captcha using the reportGood/reportBad methods.

To get the siteKey: Open the webpage, view source, ctrl+f "data-sitekey".

```JavaScript
  TwoCaptcha = require('2captcha-wrapper');

  const apiKey = '123tyg231yg123v32g123u'; //Your 2captcha api key
  const captchaTimeout = 180000; //The maximum amount of time (ms) to wait for the captcha to be solved.

  const siteCaptcha = {
    siteKey: 'uadsuadsuyasduvsduv', //The url's siteKey
    url: 'www.example.com', //The url in which the captcha appears
    invisible: false, //Whether or not the captcha is invisible
  }

  async function main() {
    var tcaptcha = new TwoCaptcha(apiKey, captchaTimeout);
    var captchaToken = await tcaptcha.solve(siteCaptcha);
    console.log('Got token!');
    console.log(captchaToken);
  }

  main();
```

## Author

Ícaro Augusto

* [https://icaroaugusto.com](https://icaroaugusto.com)
* Discord: **IcaroAugusto#3303**

## Changelogs

### 1.0.0

Created.

---
_Source: https://npm.io/package/2captcha-wrapper · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
