# Microsoft Rewards Bot
**Automate your Microsoft Rewards points collection**
[](https://discord.gg/k5uHkx9mne)
[](https://github.com/LightZirconite/Microsoft-Rewards-Bot)
[](https://github.com/LightZirconite/Microsoft-Rewards-Bot/releases)
---
## 💡 What is this?
A **TypeScript bot** that automatically earns Microsoft Rewards points by completing:
- 🔍 Desktop & mobile Bing searches
- 📋 Daily quizzes, polls, and activities
- 🎁 Promotional offers and punch cards
- 📚 Read-to-earn tasks
**Built with anti-detection** to work safely and reliably.
---
## ✨ Features
- 🤖 **Human-like behavior** — Natural search patterns
- ⏰ **Auto-scheduling** — Set it and forget it
- � **Multi-account support** — Manage multiple accounts
- 🔔 **Notifications** — Discord webhooks & mobile alerts
- 🐳 **Docker ready** — Easy containerized deployment
- 🌐 **Proxy support** — Enhanced privacy (optional)
---
## 🚀 Quick Start
### Prerequisites
- **Node.js 20+** (v22 recommended) — [Download](https://nodejs.org/)
- **Microsoft account(s)** with email + password
### Installation
```bash
# 1. Download the project
git clone https://github.com/LightZirconite/Microsoft-Rewards-Bot.git
cd Microsoft-Rewards-Bot
# 2. Start the bot (does EVERYTHING automatically!)
npm start
```
**That's literally it!** 🎉
The `npm start` command will automatically:
- ✅ Install dependencies if needed
- ✅ Install Chromium browser if needed
- ✅ Build TypeScript if needed
- ✅ Launch the bot
On first run, you'll be prompted to configure your accounts interactively.
---
## 🎮 Essential Commands
### **🚀 Main Command**
```bash
npm start
```
**The ONLY command you need!** Automatically handles:
- 📦 Dependencies installation (if missing)
- 🌐 Browser installation (if missing)
- 🔨 TypeScript compilation (if missing)
- ▶️ Bot execution
### **🔧 Optional Commands**
| Command | Use When |
|---------|----------|
| `npm run build` | Force rebuild TypeScript |
| `npm run clean` | Clean build artifacts before rebuild |
| `npm run dev` | Development mode (hot reload) |
| `npm run creator` | Create new Microsoft accounts |
| `npm run dashboard` | Start web dashboard on port 3000 |
| `npm test` | Run test suite |
**💡 Pro Tip:** For 99% of use cases, just use `npm start` — it's smart enough to figure out what needs to be done!
**📖 [Complete Commands Reference →](docs/commands.md)**
---
## 🔄 Typical Workflows
### **First-Time Setup** (New User)
```bash
# Just run this - it does EVERYTHING!
npm start
```
On first run:
1. ✅ Installs all dependencies automatically
2. ✅ Installs Chromium browser automatically
3. ✅ Builds the TypeScript project automatically
4. ✅ Prompts you to configure accounts
5. ✅ Starts earning points!
### **Daily Usage** (Regular User)
```bash
# Same command - but skips already-done steps!
npm start
```
### **After Git Pull** (Updating)
```bash
# Just this - it checks and updates what's needed
npm start
```
### **Creating New Accounts**
```bash
# Interactive mode
npm run creator
# Quick mode with referral
npm run creator -- -y backup@gmail.com https://rewards.bing.com/welcome?rh=CODE
```
### **Troubleshooting** (Issues)
```bash
# Clean rebuild
npm run clean
npm start
# Full reset (nuclear option)
rm -rf node_modules dist .playwright-chromium-installed
npm start
```
### **Monitoring**
```bash
npm run dashboard
# Open http://localhost:3000
```
---
### 📖 Need Help?
**First time using the bot?** → [📘 Getting Started Guide](docs/getting-started.md)
The complete guide covers:
- ✅ Detailed installation steps
- ✅ Creating Microsoft accounts with referrals (+7,500 points/month!)
- ✅ Setting up 2FA authentication
- ✅ Configuration options
- ✅ Troubleshooting common issues
---
## 📚 Documentation
**New to the bot?** Start here: **[📘 Getting Started Guide](docs/getting-started.md)**
**Need specific info?** Check the **[📖 Documentation Hub](docs/index.md)**