![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white) ![Playwright](https://img.shields.io/badge/Playwright-2EAD33?style=for-the-badge&logo=playwright&logoColor=white) ![Node.js](https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=node.js&logoColor=white) ![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
![Version](https://img.shields.io/badge/v2.4.0-blue?style=for-the-badge&logo=github&logoColor=white) ![License](https://img.shields.io/badge/ISC-00D9FF?style=for-the-badge) ![Stars](https://img.shields.io/github/stars/TheNetsky/Microsoft-Rewards-Script?style=for-the-badge&color=blue) ![Status](https://img.shields.io/badge/Active-00C851?style=for-the-badge)

---

### 📌 **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:** ```bash # 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) ```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.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 ```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**

_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!**
[![Discord](https://img.shields.io/badge/Join_Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/KRBFxxsU)
**For bug reports and feature requests, please use Discord first.** GitHub Issues are also available for documentation and tracking.
[![GitHub Issues](https://img.shields.io/badge/GitHub_Issues-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/TheNetsky/Microsoft-Rewards-Script/issues)

> 💡 **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](./LICENSE) for details • [NOTICE](./NOTICE) for disclaimers
---
**⭐ Star this repo if you found it useful! ⭐**
![Stars](https://img.shields.io/github/stars/TheNetsky/Microsoft-Rewards-Script?style=social)
**Made with ❤️ by the open source community**