README

hSolve

A library for solving HCaptcha.

Installation

$ npm install hsolve

Usage

const hsolve = require('hsolve');

// Typescript: import hsolve from 'hsolve';

/* RANDOM SOLUTIONS */

const token = await hsolve("https://captcha.website/"); // => P0_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwYXNza2V...


/* AWS */

const token = await hsolve("https://captcha.website/", {
    solveService: {
        name: "aws",
        awsAccessKey: "xxxxxxxxxxxxx",
        awsSecretAccessKey: "xxxxxxxxxxxxx",
        awsRegion: "xxxxxxxxxxxxx",
    },
}); // => P0_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwYXNza2V...


/* AZURE */

const token = await hsolve("https://captcha.website/", {
    solveService: {
        name: "azure",
        azureApiKey: "xxxxxxxxxxxxx",
        azureEndpoint: "xxxxxxxxxxxxx",
    },
}); // => P0_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwYXNza2V...


/* CUSTOM */

const token = await hsolve("https://captcha.website/", {
    solveService: {
        name: "custom",
        customUrl: "https://custom-api.com/",
    },
}); // => P0_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwYXNza2V....

For custom solving solution code makes a GET request to the API url with imageurl parameter and expects a json response. Example json response from your api:

{ success: true, message: [{ className: "bicycle" }] }

Maintainer

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT

Heavily inspired by https://github.com/JimmyLaurent/hcaptcha-solver

Usage no npm install needed!