```
╔══════════════════════════════════════════════════════════════════════════════╗
║ 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)
```bash
# 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**
```bash
# 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 ║
╚══════════════════════════════════════════════════════════════════════════════╝
```
```bash
# 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:
```jsonc
{
"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 →](./docs/config.md)**
```
╔══════════════════════════════════════════════════════════════════════════════╗
║ 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](./docs/getting-started.md) | [Config Guide](./docs/config.md) | [Notifications](./docs/ntfy.md) |
| [Accounts Setup](./docs/accounts.md) | [Scheduler](./docs/schedule.md) | [Diagnostics](./docs/diagnostics.md) |
| [Docker Deployment](./docs/docker.md) | [Humanization](./docs/humanization.md) | [Buy Mode](./docs/buy-mode.md) |
| | [Proxy Configuration](./docs/proxy.md) | |
**[📚 Complete Documentation Index →](./docs/index.md)**
```
╔══════════════════════════════════════════════════════════════════════════════╗
║ 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](https://playwright.dev/) — Browser automation framework
- [Rebrowser](https://github.com/rebrowser/rebrowser-playwright) — Anti-fingerprinting extensions
- [fingerprint-generator](https://www.npmjs.com/package/fingerprint-generator) — Device consistency
- [Cheerio](https://cheerio.js.org/) — Fast HTML parsing
- [Luxon](https://moment.github.io/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**
### **All Contributors**
```
╔══════════════════════════════════════════════════════════════════════════════╗
║ COMMUNITY & SUPPORT ║
╚══════════════════════════════════════════════════════════════════════════════╝
```
### **Need Help? Found a Bug?**
**Join our Discord community — we're here to help!**
[](https://discord.gg/KRBFxxsU)
**For bug reports and feature requests, please use Discord first.**
GitHub Issues are also available for documentation and tracking.
[](https://github.com/TheNetsky/Microsoft-Rewards-Script/issues)
```
╔══════════════════════════════════════════════════════════════════════════════╗
║ LICENSE ║
╚══════════════════════════════════════════════════════════════════════════════╝
```
**ISC License** — Free and open source
See [LICENSE](./LICENSE) for details • [NOTICE](./NOTICE) for disclaimers
---
**⭐ Star this repo if you found it useful! ⭐**
**Made with ❤️ by the open source community**
