Git Product home page Git Product logo

hooman's Introduction

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-dependency

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(url, {
  captchaKey: '2captcha_or_rucaptcha_api_key',
  rucaptcha: true | false, // optional (default false)
});
console.log(response.body);

You can also set environment variable HOOMAN_CAPTCHA_KEY and HOOMAN_RUCAPTCHA

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.

Custom Captcha Handling
const response = await hooman.get(url, {
  // required
  captchaKey: 'your_captcha_api_key',
  // use with captchaKey, should return captcha response string or undefined
  onCaptcha: ({ key, pageurl, sitekey, method }) => {
    // solve captcha here
    return h_captcha_response;
  },
});
console.log(response.body);
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

If you open any issue, please respect issue template and provide clean and re-producible example code which can be run without any modification. Low effort issue will be ignored.


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

hooman's People

Contributors

sayem314 avatar davodm avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.