🤖 AI Quiz Automation

AI-powered browser automation using Chrome DevTools Protocol

📚 Full Documentation • 🚀 Quick Start • ⚙️ Configuration

---

Overview

A proof-of-concept tool demonstrating AI integration with browser automation. Connects to Chrome via DevTools Protocol, extracts quiz questions using CSS selectors, and uses OpenAI to generate answers.

⚠️ Educational use only — See ethical guidelines

Quick Start

# Install dependencies
npm install

# Add OpenAI API key
echo "OPENAI_API_KEY=your-key-here" > .env

# Configure selectors for your quiz site
cp config.example.json config.json

# Start Chrome with debugging enabled (macOS shown - see Setup Guide for other OS)
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

# Run the automation
npm start

Key Features

• 🔌 Chrome DevTools Protocol — Connect to existing browser sessions
• 🎯 CSS Selector Configuration — Adapt to any quiz site in minutes
• 🤖 OpenAI Integration — AI powered answer selection
• ⏱️ Human-like Timing — Configurable delays for realistic interaction
• 📝 Multi-select Detection — Automatically handles different question types

Documentation

📘 Visit bcanfield.github.io/ai-quiz-automation for complete documentation:

• Setup Guide — Installation and configuration
• Testing — Run the example quiz
• Adapting — Configure for different quiz sites
• Configuration Reference — All available options
• Architecture — Technical deep dive
• Troubleshooting — Common issues

⚠️ Important

This is a proof of concept for educational purposes only. Using automation on real assessments may:

• Violate academic integrity policies
• Break platform terms of service
• Be illegal under computer fraud laws

Read the ethical use guidelines before proceeding.

License

MIT — Use responsibly and at your own risk.