Track the completion of sports games from a URL.
HTML JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Track the completion of sports games from a URL.


Build Status


const Scores = require('scores');

new Scores({
  url: '',
  interval: '5m', // or a number of ms
  timezone: 'America/New_York',
  dailyCutoff: 180, // in minutes
  parse: {
    // Is used to try and guess the ending time of the event
    // In this case we are checking for college basketball where
    // there are two 20 minute halves. Eg NBA would be '12m' and 4
    finalPeriod: 2,
    periodLength: '20m' // or a number of ms
// Will be fired on the completion of each game
.on('event', (game) => console.log(game))
// Start the watcher

How does it work?

It intermittently parses the DOM of the URL to see if any games have been completed. There is also logic for what to do in situations where there are no games that day or none of the games have started, or all the games have finished.


new Scores(options)

  • options.interval (Integer, default: 15) Interval in minutes for how often to request the url
  • options.timezone (String, default: 'America/New_York') A moment-timezone string for which timezone you want to base dates off
  • options.dailyCutoff (Integer, default: 180) The amount of minutes after midnight that the date should switch. This allows you to keep checking for the games that might go past midnight.
  • options.url (String) The url to request. {date} will be replaced with today's date as YYYYMMDD
  • options.logger A bucker compatible instance which will log interesting things
  • options.parse (Object) Options that will be passed directly to the parse method


  • start() Start the interval to watch for new games
  • stop() Stop watching


  • scores.on('event', event => { ... })
  • scores.on('error', err => { ... })

MIT License