AIAgentClassSelect is a Python-based AI agent that automatically searches, summarizes, and categorizes courses and activities suitable for children ages 6–8. It integrates web scraping with AI summarization (OpenAI GPT) and can run weekly using GitHub Actions.
- Scrapes multiple websites for kids' courses and activities
- Cleans, deduplicates, and categorizes courses (STEM, Art, Dance, etc.)
- Uses GPT API to summarize courses and generate Markdown outputs
- Tracks new and updated courses with historical comparison
- Optional email/Slack notifications with weekly updates
- Fully automated using GitHub Actions
- Python 3.11+
- Packages:
requests,beautifulsoup4,openai - GitHub repository for automated workflow
- OpenAI API Key
- Optional: SMTP credentials for email notifications
- Clone the repository:
git clone https://github.com/scmbuildrelease/AIAgentClassSelect.git
cd AIAgentClassSelect- Install Python dependencies:
pip install --upgrade pip
pip install requests beautifulsoup4 openai- Set environment variables (recommended via GitHub Secrets for automation):
export OPENAI_API_KEY="your_openai_api_key"
export EMAIL_USER="[email protected]" # optional
export EMAIL_PASS="your_email_password" # optional- Usage Run the script locally:
python scrape_courses.py
- GitHub Actions Automation
The project includes a GitHub Actions workflow .github/workflows/weekly_courses.yml:
Runs weekly on a schedule (cron) or manually (workflow_dispatch) Fetches course data, generates Markdown, and commits updates to the repository Optional: sends email notifications for weekly updates