---

📌 Update Notice

Recent updates changed the structure of config.jsonc and accounts.jsonc files (including extensions).

If you see Git conflicts during git pull on these files:

# Delete and fresh clone
rm -rf Microsoft-Rewards-Script
git clone -b v2 https://github.com/TheNetsky/Microsoft-Rewards-Script.git
cd Microsoft-Rewards-Script

# Manually re-enter your settings in the new files

⚠️ Don't copy old config files directly—structure has changed. Re-enter your credentials and preferences manually.

This notice will remain for a few releases. Once we reach stable v2.5+, automatic updates will work smoothly again.

---

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.jsonc 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.

💡 Looking for enhanced builds? Community-maintained versions with faster updates and advanced features may be available. Ask in our Discord for more info.

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