Skip to content
forked from sayem314/hooman

http interceptor to hoomanize cloudflare requests

License

Notifications You must be signed in to change notification settings

andress134/hooman

 
 

Repository files navigation

hooman JS-Challange

HTTP interceptor using got to bypass Cloudflare DDOS protection / JavaScript challenge on Node.js

JS-Challange hCaptcha

hooman is not meant for spamming, please use it sanely.

Install

# with npm: npm i hooman got
yarn add hooman got

got is peer-dependencies

Usage Example

GET HTML
const hooman = require('hooman');

(async () => {
  try {
    const response = await hooman.get('https://sayem.eu.org');
    console.log(response.body);
    //=> '<!doctype html> ...'
  } catch (error) {
    console.log(error.response.body);
    //=> 'Internal server error ...'
  }
})();
POST JSON
const { body } = await hooman.post('https://httpbin.org/anything', {
  json: {
    hello: 'world',
  },
  responseType: 'json',
});
console.log(body.data);
//=> {hello: 'world'}
Pipe Stream
// This is mandatory to set cookie first since .stream() doesn't fire hooks
await hooman(jsChallengePage);

// Now we can download files
const image = fs.createWriteStream('image.jpg');
hooman.stream(imageUrl).pipe(image);
Captcha
const response = await hooman.get('https://sayem.eu.org', {
  captchaKey: '2captcha_or_rucaptcha_api_key',
  rucaptcha: true | false, // optional (default false)
});
console.log(response.body);

All you need to do is provide captchaKey and rest is done by hooman. It automatically detects if g/hCaptcha is present and need solving or can be solved. There are console.log print on hit as well.

Note that if you make multiple request to same site at once only the first request will be sent for captcha solving while other request will be hanged until captcha is solved. You might face multiple trigger to captcha, please monitor your usage. Best practice is to make a dummy request first and let hooman solve captcha and then process further requests.

Proxy
const HttpsProxyAgent = require('https-proxy-agent');

const proxy = new HttpsProxyAgent('http://127.0.0.1:3128');

const response = await hooman('https://sayem.eu.org', {
  agent: {
    https: proxy,
  },
});

API

Please see available API here.

All methods and props of got should work fine.

Support

I don't make any profit with this library. If you want to show your appreciation, you can donate me here 🙀 Thanks! You can also hire me for scraping solution, ping me and we will discuss further 😄

Made with ❤️ & ☕ by Sayem

About

http interceptor to hoomanize cloudflare requests

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%