https://github.com/kypkk/ncu_gpa_calculator

A tool for NCU student that makes calculating GPA easier
https://github.com/kypkk/ncu_gpa_calculator

cheerio-node node-js puppeteer puppeteer-extra puppeteer-extra-recaptcha-plugin ts-node-dev typescript webscraping

Last synced: 3 days ago
JSON representation

A tool for NCU student that makes calculating GPA easier

• Host: GitHub
• URL: https://github.com/kypkk/ncu_gpa_calculator
• Owner: kypkk
• Created: 2023-05-14T17:01:57.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-10-19T08:45:53.000Z (about 1 year ago)
• Last Synced: 2024-11-07T01:32:12.090Z (about 2 months ago)
• Topics: cheerio-node, node-js, puppeteer, puppeteer-extra, puppeteer-extra-recaptcha-plugin, ts-node-dev, typescript, webscraping
• Language: TypeScript
• Homepage:
• Size: 51.8 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# NCU_GPA_Calculator

This is web scraping program for all NCU students to calculate their overall GPA.

## About this project

### Motivation

- Since calculating the GPA by hand is a waste of time and the existing google extension no longer suppoprt the new portal so I decided to build one myself

- It has been tested with my own account and my girlfriend's account it's both correct

### Dependencies

- #### puppeteer-extra & puppeteer-extra-plugin-recaptcha

  puppeteer is a Node.js library that provides a high-level API to control Chrome/Chromium over the DevTools Protocol. Puppeteer-extra is a light-weight wrapper around puppeteer that enables typescript support and lots of cool plugins. puppeteer-extra-plugin-recaptcha is one of the puppeteer plugins that helps solve recaptcha problems.

- #### cheerio

  cheerio is a Node.js library for parsing and manipulating HTML and XML.

## Usage

1. Clone this repository

```shell

git clone https://github.com/kypkk/NCU_GPA_Calculator.git

```

2. cd into the directory and install all the dependencies

```shell

cd NCU_GPA_Calculator

npm i

```

3. Create a new .env file in the directory and put your portal account, portal password and [2captcha](https://2captcha.com/enterpage) api key into it

4. Finally run the index.ts in your shell

```shell

npm start

```