NBA Scoreboard Scraper Agent

A Python agent that continuously scrapes the ESPN NBA scoreboard, detects newly completed games, and emails a summary table.

Features

• Fetches live NBA scoreboard data from ESPN's public API
• Displays scores, odds, venue, broadcast info, and player leaders in the console
• Tracks completed games between checks using a local state.json file
• Sends an HTML email with a formatted results table when new games finish

Quick Start (WSL)

# 1. Navigate to the project
cd /mnt/c/Projects/python/Scraper

# 2. Make scripts executable & run setup
chmod +x setup.sh run.sh
./setup.sh

# 3. Edit .env with your SMTP credentials
nano .env

# 4. Run the agent
./run.sh          # continuous loop (default: every 5 minutes)
./run.sh once     # single check

Email Configuration

The agent uses SMTP to send emails. For Gmail, create an App Password and set it in .env:

Variable	Description
SMTP_HOST	SMTP server (default: smtp.gmail.com)
SMTP_PORT	SMTP port (default: 587)
SMTP_USER	Your email address
SMTP_PASS	App password
EMAIL_TO	Recipient email
CHECK_INTERVAL	Seconds between checks (default: 300)

Files

File	Purpose
scraper.py	Main agent (scrape, detect, email)
setup.sh	One-time environment setup
run.sh	Launch the agent
.env.example	Template for environment variables
state.json	Auto-created runtime state
requirements.txt	Python dependencies