https://github.com/asecco/espn-cbb-247-recruits

A simple browser script for passionate CBB fans to access 247Sports HS recruiting info effortlessly!
https://github.com/asecco/espn-cbb-247-recruits

247sports college-basketball espn tampermonkey userscript web-scraping

Last synced: about 1 month ago
JSON representation

A simple browser script for passionate CBB fans to access 247Sports HS recruiting info effortlessly!

• Host: GitHub
• URL: https://github.com/asecco/espn-cbb-247-recruits
• Owner: asecco
• License: mit
• Created: 2024-04-28T08:16:07.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2024-04-29T06:34:02.000Z (7 months ago)
• Last Synced: 2024-10-02T05:42:39.490Z (about 1 month ago)
• Topics: 247sports, college-basketball, espn, tampermonkey, userscript, web-scraping
• Language: JavaScript
• Homepage:
• Size: 66.4 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  

 



ESPN CBB 247 Recruits




  [![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/asecco/espn-cbb-247-recruits/total?style=for-the-badge)](https://github.com/asecco/espn-cbb-247-recruits/releases/latest)

  [![GitHub stars](https://img.shields.io/github/stars/asecco/espn-cbb-247-recruits?style=for-the-badge)](https://github.com/asecco/espn-cbb-247-recruits/stargazers)

  [![GitHub Issues](https://img.shields.io/github/issues/asecco/espn-cbb-247-recruits.svg?style=for-the-badge)](https://github.com/asecco/espn-cbb-247-recruits/issues)





  Getting Started •

  Limitations



---

 A simple browser script for passionate CBB fans to access 247Sports HS recruiting info effortlessly!

  
 



  

Like what you see? Please consider giving ESPN CBB 247 Recruits a GitHub star ⭐, it will help a lot!


## Getting Started

### Installation

You can install the script as a **[Userscript](https://en.wikipedia.org/wiki/Userscript)** in all popular browsers. In the future, there may be other installation methods, such as browser extensions.

#### Userscript

1. Install a [Userscript Manager](https://en.wikipedia.org/wiki/Userscript_manager) of your choice, such as [Tampermonkey](https://www.tampermonkey.net/).

2. Install **ESPN CBB 247 Recruits** by clicking **[here](https://github.com/asecco/espn-cbb-247-recruits/releases/latest/download/espn-cbb-247-recruits.user.js)**.

3. Done! Browse a CBB player's ESPN page and view their HS recruit ranking.

![example](https://github.com/asecco/espn-cbb-247-recruits/assets/40510223/f8ce2998-6135-402c-8bcf-36d0ac3dc889)

## Limitations

Recruiting information is retrieved by scraping 247Sports annual composite recruit rankings, however, this comes with some known limitations.

- For efficiency in searching for a recruit's name in the rankings, I'm only looking through the first 5 pages(top 250 recruits). If you want to change this, replace the `maxPage` constant with a value of your choosing.

  - **There's a max of ~10 pages with 50 recruits per page**

    ```js

    const maxPage = 5;

    ```

- Inconsistencies in the player's name on ESPN and 247Sports may lead to the script not finding the player's ranking. Many differences are accounted for, such as **'John Doe Jr'** vs **'John Doe'** or **'A.J.'** vs **'AJ'**, which still lead to matches, but there are still rare exceptions where matching fails.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.