Skip to content

sruusk/esea-scraper

Repository files navigation

CodeQL

esea-scraper

A consumable Node package to scrape data from ESEA. Due to ESEAs API being protected by Cloudflare, the best approach is to spin up a headless browser and scrape the API.
Ulixee Hero is used to bypass Cloudflare.

Usage

Install

To start, it's best to run with a local Hero Core, so you should install @ulixee/hero-core as a peer dependency:

npm i esea-scraper @ulixee/hero-core

Later, if you'd like to use a remote Hero Core, you can remove the @ulixee/hero-core peer dependency.

Example Usage

  • Typescript:
import { EseaScraper } from 'esea-scraper';

const esea = new EseaScraper();
await esea.getPlayer('2570455');
  • Javascript:
const eseaScraper = require('esea-scraper');
const esea = new eseaScraper.EseaScraper();
await esea.getPlayer('2570455');

Development

To contribute to the repo, you should install the dependencies of the project.

npm i

In order to verify your code works, you should make a relevant test for it, and check your tests pass using the following command:

npm run test