Microsoft-Rewards-Script/README.md

╔══════════════════════════════════════════════════════════════════════════════╗
║                          WHAT DOES THIS DO?                                  ║
╚══════════════════════════════════════════════════════════════════════════════╝

Automate your Microsoft Rewards daily activities with intelligent browser automation.
Complete searches, quizzes, and promotions automatically while mimicking natural human behavior.

Daily Earnings Breakdown

🎯 Activity	💎 Points	⏱️ Time
Desktop Searches	~90 pts	30 sec
Mobile Searches	~60 pts	20 sec
Daily Set Tasks	~30-50 pts	1-2 min
Promotions & Punch Cards	Variable	30s-2min
📊 TOTAL AVERAGE	150-300+ pts	3-5 min

╔══════════════════════════════════════════════════════════════════════════════╗
║                             QUICK START                                      ║
╚══════════════════════════════════════════════════════════════════════════════╝

🚀 Automated Setup (Recommended)

# Windows
setup\setup.bat

# Linux / macOS / WSL
bash setup/setup.sh

# Universal
npm run setup

The wizard handles everything:

• ✅ Creates accounts.json with your credentials
• ✅ Installs dependencies & builds project
• ✅ Runs first automation (optional)

🛠️ Manual Setup

# 1. Clone repository
git clone -b v2 https://github.com/TheNetsky/Microsoft-Rewards-Script.git
cd Microsoft-Rewards-Script

# 2. Configure accounts
cp src/accounts.example.json src/accounts.json
# Edit accounts.json with your Microsoft credentials

# 3. Install & build
npm i

# 4. Run automation
npm start

╔══════════════════════════════════════════════════════════════════════════════╗
║                        INTELLIGENT FEATURES                                  ║
╚══════════════════════════════════════════════════════════════════════════════╝

🛡️ Risk-Aware System Real-time threat detection ├─ Monitors captchas & errors ├─ Dynamic delay adjustment (1x→4x) ├─ Automatic cool-down periods └─ ML-based ban prediction 📊 Performance Analytics Track everything ├─ Points earned per day ├─ Success/failure rates ├─ Historical trends └─ Account health monitoring

🔍 Query Diversity Engine Natural search patterns ├─ Multi-source queries ├─ Pattern breaking algorithms ├─ Smart deduplication └─ Reduced detection risk ✅ Config Validator Pre-flight checks ├─ Detects common mistakes ├─ Security warnings ├─ Optimization suggestions └─ Dry-run test mode

╔══════════════════════════════════════════════════════════════════════════════╗
║                          USAGE COMMANDS                                      ║
╚══════════════════════════════════════════════════════════════════════════════╝

# Run automation once
npm start

# Daily automated scheduler
npm run start:schedule

# Manual redemption mode (monitor points while shopping)
npm start -- -buy your@email.com

# Docker deployment
docker compose up -d

# Test configuration without executing
npm start -- --dry-run

╔══════════════════════════════════════════════════════════════════════════════╗
║                           CONFIGURATION                                      ║
╚══════════════════════════════════════════════════════════════════════════════╝

Edit src/config.jsonc to customize behavior:

{
  "browser": {
    "headless": false  // Set true for background operation
  },
  "execution": {
    "parallel": false,           // Run desktop + mobile simultaneously
    "runOnZeroPoints": false,    // Skip when no points available
    "clusters": 1                // Parallel account processes
  },
  "workers": {
    "doDailySet": true,
    "doDesktopSearch": true,
    "doMobileSearch": true,
    "doPunchCards": true
  },
  "humanization": {
    "enabled": true,             // Natural human-like delays
    "actionDelay": { "min": 500, "max": 2200 },
    "randomOffDaysPerWeek": 1    // Skip random days naturally
  }
}

📖 Complete Configuration Guide →

╔══════════════════════════════════════════════════════════════════════════════╗
║                           CORE FEATURES                                      ║
╚══════════════════════════════════════════════════════════════════════════════╝

Human-Like Behavior Randomized delays • Mouse movements Natural scrolling patterns	Anti-Detection Session persistence • Fingerprinting Proxy support	Multi-Account Parallel execution • 2FA/TOTP Per-account proxies
Smart Quiz Solver Polls • ABC Quiz • This or That 4/8-option quizzes	Built-in Scheduler Daily automation No external cron needed	Notifications Discord webhooks • NTFY Real-time alerts

╔══════════════════════════════════════════════════════════════════════════════╗
║                           DOCUMENTATION                                      ║
╚══════════════════════════════════════════════════════════════════════════════╝

📖 Getting Started	⚙️ Configuration	🔔 Monitoring
Installation & Setup	Config Guide	Notifications
Accounts Setup	Scheduler	Diagnostics
Docker Deployment	Humanization	Buy Mode
	Proxy Configuration

📚 Complete Documentation Index →

╔══════════════════════════════════════════════════════════════════════════════╗
║                       TECHNICAL ARCHITECTURE                                 ║
╚══════════════════════════════════════════════════════════════════════════════╝

Built with Modern Technologies

Core Modules:

Module	Purpose
Login.ts	Microsoft authentication flow with 2FA/TOTP support
Workers.ts	Completes Daily Set, Promotions, and Punch Cards
Search.ts	Desktop/mobile Bing searches with natural query variations
Activities.ts	Routes to specific activity handlers (Quiz, Poll, etc.)
activities/*.ts	Individual handlers for each reward type

Key Technologies:

• Playwright — Browser automation framework
• Rebrowser — Anti-fingerprinting extensions
• fingerprint-generator — Device consistency
• Cheerio — Fast HTML parsing
• Luxon — Modern date/time handling

╔══════════════════════════════════════════════════════════════════════════════╗
║                      IMPORTANT DISCLAIMERS                                   ║
╚══════════════════════════════════════════════════════════════════════════════╝

⚠️ USE AT YOUR OWN RISK ⚠️

Using automation violates Microsoft's Terms of Service.
Accounts may be suspended or permanently banned.

This project is for educational purposes only.

Best Practices:

✅ DO:

• Use 2FA/TOTP for security
• Enable humanization features
• Schedule 1-2x daily maximum
• Set runOnZeroPoints: false
• Test on secondary accounts first
• Monitor diagnostics regularly

❌ DON'T:

• Run on your main account
• Schedule hourly runs
• Ignore security warnings
• Use shared proxies
• Skip configuration validation

╔══════════════════════════════════════════════════════════════════════════════╗
║                         CONTRIBUTORS                                         ║
╚══════════════════════════════════════════════════════════════════════════════╝

Core Development Team

TheNetsky 🏗️ Foundation Architect

Mgrimace 💻 Active Developer

LightZirconite 🔐 V2+

All Contributors

╔══════════════════════════════════════════════════════════════════════════════╗
║                      COMMUNITY & SUPPORT                                     ║
╚══════════════════════════════════════════════════════════════════════════════╝

Need Help? Found a Bug?

Join our Discord community — we're here to help!

For bug reports and feature requests, please use Discord first.
GitHub Issues are also available for documentation and tracking.

╔══════════════════════════════════════════════════════════════════════════════╗
║                             LICENSE                                          ║
╚══════════════════════════════════════════════════════════════════════════════╝

ISC License — Free and open source

See LICENSE for details • NOTICE for disclaimers

---

⭐ Star this repo if you found it useful! ⭐

Made with ❤️ by the open source community