npm.io
1.0.56 • Published 2 months ago

@antiadmin/anticaptchaofficial

Licence
ISC
Version
1.0.56
Deps
1
Size
68 kB
Vulns
0
Weekly
0
SummaryDependencyVersions

Official Anti-Captcha.com npm module

Contents

Official anti-captcha.com npm package for solving images with text, Recaptcha v2/v3 Enterprise/non-Enterpise, Funcaptcha, GeeTest, HCaptcha.

Anti-captcha is an oldest and cheapest web service dedicated to solving captchas by human workers from around the world. By solving captchas with us you help people in poorest regions of the world to earn money, which not only cover their basic needs, but also gives them ability to financially help their families, study and avoid jobs where they're simply not happy.

To use the service you need to register and topup your balance. Prices start from $0.0005 per image captcha and $0.002 for Recaptcha. That's $0.5 per 1000 for images and $2 for 1000 Recaptchas.

For more technical information and articles visit our documentation page.

Module installation:
npm install @antiadmin/anticaptchaofficial
Import and check your balance in sync mode:
(async() => {
    
    const ac = require("@antiadmin/anticaptchaofficial");
    ac.setAPIKey('YOUR_API_KEY');
    try {
        const balance = await ac.getBalance();
        console.log(`my balance is $${balance}`);
        if (balance <= 0) {
            throw "negative balance"
        }
        console.log("solving a captcha..")
        // const token = await ac.solveRecaptchaV2Proxyless('http://DOMAIN.COM', 'WEBSITE_KEY');
        // const fs = require('fs');
        // const text = await ac.solveImage(fs.readFileSync('captcha.png', { encoding: 'base64' }), true)
    } catch (e) {
        console.log("got error: ", e.toString());
    }
    
})();

Or do the same with promises:

const ac = require("@antiadmin/anticaptchaofficial");
ac.setAPIKey('YOUR_API_KEY');
ac.getBalance()
     .then(balance => {
         console.log('my balance is 

Disable verbose output to console:


ac.shutUp();



Request subscription credits balance:
const remainingCredits = await ac.getCreditsBalance();


Earn with Anti-Captcha


Specify softId to earn 10% commission from all captcha spendings with your app.
Get your softId in Developers Center.


ac.setSoftId(SOFT_ID_NUMBER);


 


Solve image captcha:


const fs = require('fs');
const captcha = fs.readFileSync('captcha.png', { encoding: 'base64' });

// Additional flags, see https://anti-captcha.com/apidoc/task-types/ImageToTextTask for description:
// ac.settings.phrase = true;                  // 2 words
// ac.settings.case = true;                    // case sensitivity
// ac.settings.numeric = 1;                    // only numbers
// ac.settings.comment = "only green letters"; // text comment for workers
// ac.settings.math = true;                    // math operation like 50+2
// ac.settings.minLength = 1;                  // minimum amount of characters
// ac.settings.maxLength = 10;                 // maximum number of characters
// ac.settings.languagePool = 'en';            // language pool
const text = await ac.solveImage(captcha, true);


Report last solved image captcha as incorrect (must read this before using):


await ac.reportIncorrectImageCaptcha();




 


Recaptcha V2 without proxy:


ac.settings.recaptchaDataSValue = 'set me for google.com domains';
const gresponse = ac.solveRecaptchaV2Proxyless('http://DOMAIN.COM', 'WEBSITE_KEY');
console.log('g-response: '+gresponse);
console.log('google cookies:');
console.log(ac.getCookies());
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());


Learn what to do with g-response in this article.


Report last solved Recaptcha v2/v3 as incorrect (must read this before using):


await ac.reportIncorrectRecaptcha();


Report Recaptcha v3 as correctly solved (more info here before using):


await ac.reportCorrectRecaptcha();


Recaptcha V2 with proxy:


const gresponse = await ac.solveRecaptchaV2ProxyOn('http://DOMAIN.COM',
    'WEBSITE_KEY',
    'http', //http, socks4, socks5
    'PROXY_IP',
    'PROXY_PORT',
    'PROXY_LOGIN',
    'PROXY_PASSWORD',
    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/52.0.2743.116',
    'some=cookies');


Solve Recaptcha V2-invisible (note the 3rd parameter "true"):


const gresponse = await ac.solveRecaptchaV2Proxyless('http://DOMAIN.COM', 'WEBSITE_KEY', true)
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


Recaptcha V3:


const gresponse = await ac.solveRecaptchaV3('http://DOMAIN.COM',
    'WEBSITE_KEY',
    0.3, //minimum score required: 0.3, 0.7 or 0.9
    'PAGE_ACTION_CAN_BE_EMPTY');
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());


Solve Recaptcha V2 Enterprise without proxy:


const gresponse = await ac.solveRecaptchaV2EnterpriseProxyless(
    'http://DOMAIN.COM', 
    'WEBSITE_KEY', 
    {   //enterprise payload:
        "s" : "SOME_TOKEN",
        "custom_parameter" : "string_number_boolean" 
    });
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


HCaptcha without proxy:


const token = await ac.solveHCaptchaProxyless('http://DOMAIN.COM', 'WEBSITE_KEY', 'FULL USER AGENT HERE');

// use this userAgent for posting the form with token!
const userAgent = ac.getHcaptchaUserAgent();

//some Hcaptchas also produce "respkey" value, this is how to get it:
const respKey = ac.getHcaptchaRespKey();



Report last solved Hcaptcha as incorrect:


await ac.reportIncorrectHcaptcha();




 


Turnstile without proxy:


const token = await ac.solveTurnstileProxyless('http://DOMAIN.COM', 'WEBSITE_KEY', 'optional_action', 'optional_cData_token');
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


Turnstile with proxy:


const token = await ac.solveTurnstileProxyOn('http://DOMAIN.COM',
    'WEBSITE_KEY',
    'http', //http, socks4, socks5
    'PROXY_IP',
    'PROXY_PORT',
    'PROXY_LOGIN',
    'PROXY_PASSWORD',
    'optional_action',
    'optional_cData_token');
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


AntiGate Tasks:


const solution = await ac.solveAntiGateTask(
    'http://antigate.com/logintest.php', 
    'Sign-in and wait for control text', 
    { 
        "login_input_css": "#login",
        "login_input_value": "the login",
        "password_input_css": "#password",
        "password_input_value": "the password",
        "control_text": "You have been logged successfully" 
    });
console.log('cookies: ', solution.cookies);
console.log('localStorage: ', solution.localStorage);
console.log('url: ', solution.url);


same with a proxy:


const solution = await ac.solveAntiGateTask(
    'http://antigate.com/logintest.php', 
    'Sign-in and wait for control text', 
    { 
        "login_input_css": "#login",
        "login_input_value": "the login",
        "password_input_css": "#password",
        "password_input_value": "the password",
        "control_text": "You have been logged successfully" 
    },
    'PROXY_IP',
    'PROXY_PORT',
    'PROXY_LOGIN',
    'PROXY_PASSWORD');


Send a task with a delayed variable and push it after a few seconds:


const taskId = await ac.sendAntiGateTask('http://antigate.com/logintest2fa.php',
    'Sign-in with 2FA and wait for control text',
    {
        "login_input_css": "#login",
        "login_input_value": "the login",
        "password_input_css": "#password",
        "password_input_value": "the password",
        "2fa_input_css": "#2facode",
        "2fa_input_value": "_WAIT_FOR_IT_",
        "control_text": "You have been logged successfully"
    });
await ac.delay(5000); //simulate a delay in 2FA retrieval
await ac.pushAntiGateVariable('2fa_input_value', '349001');
const solution = await ac.waitForResult(taskId);

console.log('solution:');
console.log(solution);



 


Funcaptcha / Arkoselabs without proxy:


//optional data blob:
ac.settings.funcaptchaDataBlob = 'blob value here is any, or leave it empty';
const token = await ac.solveFunCaptchaProxyless(
    'https://www.thewebsite.com/path',
    'site-key');
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());


 


Funcaptcha / Arkoselabs via proxy:


//optional data blob:
ac.settings.funcaptchaDataBlob = 'blob value here is any, or leave it empty';
const token = await ac.solveFunCaptchaProxyOn(
    'https://www.thewebsite.com/path',
    'site-key', 
    'http',
    '1.2.3.4',
    3128,
    'proxy-login',
    'proxy-password',
    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/52.0.2743.116',
    '');
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


Geetest version 3 without proxy


See tutorial how to find these parameters.


const token = await ac.solveGeeTestProxyless(
    'https://www.thewebsite.com/path',
    'gt key 32 bytes',
    'challenge value 32 bytes',
    'optional.api-domain.com');
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());


 


Geetest version 4 without proxy


See tutorial how to find these parameters.


const token = await ac.solveGeeTestV4Proxyless(
    'https://www.thewebsite.com/path',
    'captchaId key 32 bytes',
    'optional.api-domain.com',
    {
        'riskType': 'slide' //example
    });
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


Image to coordinates


const fs = require('fs');
const captcha = fs.readFileSync('captcha.png', { encoding: 'base64' });
const coordinates = await ac.solveImageToCoordinates(captcha, "Select all objects in specified order", "points");


Report last solved image captcha as incorrect:


await ac.reportIncorrectImageCaptcha();




 


Prosopo captcha


const token = await ac.solveProsopoProxyless('http://DOMAIN.COM', 'WEBSITE_KEY');




 


Solve Prosopo captcha with proxy:


const token = await ac.solveProsopoProxyOn('http://DOMAIN.COM',
    'WEBSITE_KEY',
    'http', //http, socks4, socks5
    'PROXY_IP',
    'PROXY_PORT',
    'PROXY_LOGIN',
    'PROXY_PASSWORD');
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


Friendly Captcha without proxy:


const token = await ac.solveFriendlyCaptchaProxyless('http://DOMAIN.COM', 'WEBSITE_KEY');
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


Solve Friendly Captcha with proxy:


const token = await ac.solveFriendlyCaptchaProxyOn('http://DOMAIN.COM',
    'WEBSITE_KEY',
    'http', //http, socks4, socks5
    'PROXY_IP',
    'PROXY_PORT',
    'PROXY_LOGIN',
    'PROXY_PASSWORD');
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


Amazon WAF:


Two options here:


    

  1. When captcha is at the bot filtering page and you need aws-was-token cookie:
    2. 



without proxy:


const token = await ac.solveAmazonProxyless('http://DOMAIN.COM', 
    'key_value_from_window.gokuProps_object',
    'iv_value_from_window.gokuProps_object',
    'context_value_from_window.gokuProps_object',
    'https://e9b10f157f38.9a96e8b4.us-gov-west-1.captcha.awswaf.com/e9b10f157f38/76cbcde1c834/2a564e323e7b/captcha.js', //optional
    'https://e9b10f157f38.9a96e8b4.us-gov-west-1.token.awswaf.com/e9b10f157f38/76cbcde1c834/2a564e323e7b/challenge.js'  //optional
); 
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());


with proxy:


const token = await ac.solveAmazonProxyOn('http://DOMAIN.COM',
    'key_value_from_window.gokuProps_object',
    'http', //http, socks4, socks5
    'PROXY_IP',
    'PROXY_PORT',
    'PROXY_LOGIN',
    'PROXY_PASSWORD',
    'iv_value_from_window.gokuProps_object',
    'context_value_from_window.gokuProps_object',
    'https://e9b10f157f38.9a96e8b4.us-gov-west-1.captcha.awswaf.com/e9b10f157f38/76cbcde1c834/2a564e323e7b/captcha.js', //optional
    'https://e9b10f157f38.9a96e8b4.us-gov-west-1.token.awswaf.com/e9b10f157f38/76cbcde1c834/2a564e323e7b/challenge.js'  //optional
);
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());


    

  1. When captcha is a standalone widget which is triggered by user's action:
    2. 



without proxy:


const token = await ac.solveAmazonWidgetProxyless('http://DOMAIN.COM', 
    'widget_api_key',     // get key from AwsWafCaptcha.renderCaptcha function
    'https://164cb210e333.edge.captcha-sdk.awswaf.com/164cb210e333/jsapi.js' // full path to jsapi.js integration script
); 
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());


with proxy:


const token = await ac.solveAmazonWidgetProxyOn('http://DOMAIN.COM',
    'widget_api_key',
    'https://164cb210e333.edge.captcha-sdk.awswaf.com/164cb210e333/jsapi.js', // full path to jsapi.js integration script
    'http', //http, socks4, socks5
    'PROXY_IP',
    'PROXY_PORT',
    'PROXY_LOGIN',
    'PROXY_PASSWORD'
);
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());


For more details visit Anti-Captcha Amazon WAF documentation.




 


Altcha captcha without proxy:


// with challenge URL:
const token = await ac.solveAltchaProxyless('http://DOMAIN.COM', '/some/challenge/url');

// with challenge JSON retrieved from challengeurl:
const token = await ac.solveAltchaProxyless('http://DOMAIN.COM', '', '{"algorithm":"SHA-256","challenge":"2a40f7ba3393f9513011179de41c7221f14e563856de2f647233a00accf9c28b","salt":"08d7f273d79df143355b9e5n","signature":"1de2bbf282420aef6ca0a84c38c85e2b1e40023d28bef72278d735555a8f47fb"}');
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


Solve Altcha captcha with proxy:


// with challenge URL:
const token = await ac.solveAltchaProxyOn('http://DOMAIN.COM',
    '/some/challenge/url',
    null,
    'http', //http, socks4, socks5
    'PROXY_IP',
    'PROXY_PORT',
    'PROXY_LOGIN',
    'PROXY_PASSWORD');

// with challenge JSON retrieved from challengeurl:
const token = await ac.solveAltchaProxyOn('http://DOMAIN.COM',
    '',
    '{"algorithm":"SHA-256","challenge":"2a40f7ba3393f9513011179de41c7221f14e563856de2f647233a00accf9c28b","salt":"08d7f273d79df143355b9e5n","signature":"1de2bbf282420aef6ca0a84c38c85e2b1e40023d28bef72278d735555a8f47fb"}',
    'http', //http, socks4, socks5
    'PROXY_IP',
    'PROXY_PORT',
    'PROXY_LOGIN',
    'PROXY_PASSWORD');

// in case you need it and it is available:
console.log('worker\'s user-agent:');
console.log(ac.getUserAgent());




 


Other available task types with similar method calls, see source code:


await ac.solveRecaptchaV2EnterpriseProxyOn( ... ); //Recaptcha V2 Enterprise with proxy
await ac.solveRecaptchaV3Enterprise( ... ); //Recaptcha V3 Enterprise
await ac.solveHCaptchaProxyOn( ... ); //hCaptcha with proxy
await ac.solveGeeTestProxyOn( ... ); //Solve Geetest with proxy
await ac.solveGeeTestV4ProxyOn( ... ); //Bypass Geetest V4 with proxy

 + balance)
         if (balance <= 0) {
             return false;
         }
         console.log("solving a captcha..")
         // ac.solveRecaptchaV2Proxyless('http://DOMAIN.COM', 'WEBSITE_KEY')
         //     .then(token => {
         //         console.log('Got g-response:', token)
         //         // do something
         //     })
         //     .catch(error => {
         //         console.log('test received error ' + error)
         //         return false;
         //     });
     })
     .catch(error => console.log('received error '+error))

Disable verbose output to console:

__CODE_BLOCK_3__
Request subscription credits balance:__CODE_BLOCK_4__
Earn with Anti-Captcha

Specify softId to earn 10% commission from all captcha spendings with your app. Get your softId in Developers Center.

__CODE_BLOCK_5__

 

Solve image captcha:
__CODE_BLOCK_6__

Report last solved image captcha as incorrect (must read this before using):

__CODE_BLOCK_7__

 

Recaptcha V2 without proxy:
__CODE_BLOCK_8__

Learn what to do with g-response in this article.

Report last solved Recaptcha v2/v3 as incorrect (must read this before using):

__CODE_BLOCK_9__

Report Recaptcha v3 as correctly solved (more info here before using):

__CODE_BLOCK_10__
Recaptcha V2 with proxy:
__CODE_BLOCK_11__

Solve Recaptcha V2-invisible (note the 3rd parameter "true"):

__CODE_BLOCK_12__

 

Recaptcha V3:
__CODE_BLOCK_13__

Solve Recaptcha V2 Enterprise without proxy:

__CODE_BLOCK_14__

 

HCaptcha without proxy:
__CODE_BLOCK_15__

Report last solved Hcaptcha as incorrect:

__CODE_BLOCK_16__

 

Turnstile without proxy:
__CODE_BLOCK_17__

 

Turnstile with proxy:
__CODE_BLOCK_18__

 

AntiGate Tasks:
__CODE_BLOCK_19__

same with a proxy:

__CODE_BLOCK_20__

Send a task with a delayed variable and push it after a few seconds:

__CODE_BLOCK_21__

 

Funcaptcha / Arkoselabs without proxy:
__CODE_BLOCK_22__

 

Funcaptcha / Arkoselabs via proxy:
__CODE_BLOCK_23__

 

Geetest version 3 without proxy

See tutorial how to find these parameters.

__CODE_BLOCK_24__

 

Geetest version 4 without proxy

See tutorial how to find these parameters.

__CODE_BLOCK_25__

 

Image to coordinates
__CODE_BLOCK_26__

Report last solved image captcha as incorrect:

__CODE_BLOCK_27__

 

Prosopo captcha
__CODE_BLOCK_28__

 

Solve Prosopo captcha with proxy:

__CODE_BLOCK_29__

 

Friendly Captcha without proxy:
__CODE_BLOCK_30__

 

Solve Friendly Captcha with proxy:

__CODE_BLOCK_31__

 

Amazon WAF:

Two options here:

  1. When captcha is at the bot filtering page and you need aws-was-token cookie:
without proxy:
__CODE_BLOCK_32__
with proxy:
__CODE_BLOCK_33__
  1. When captcha is a standalone widget which is triggered by user's action:
without proxy:
__CODE_BLOCK_34__
with proxy:
__CODE_BLOCK_35__

For more details visit Anti-Captcha Amazon WAF documentation.

 

Altcha captcha without proxy:
__CODE_BLOCK_36__

 

Solve Altcha captcha with proxy:

__CODE_BLOCK_37__

 

Other available task types with similar method calls, see source code:

__CODE_BLOCK_38__

Keywords

anticaptchacaptcharecaptchahcaptchahcaptcha enterprisehcaptcha rqdatarecaptchav2recaptcha enterprisefuncaptchaarkoselabsgeetestturnstileturnstile captchaantigate2captchadecaptcherdeathbycaptchacloudflarecloudflare bypassdatadomedatadome bypassobject coordinatesprosopofriendly captchaamazonwafamazon wafamazon-waf-tokenaltcha