Microsoft Rewards Bot

Automate your Microsoft Rewards points collection effortlessly

---

About

This TypeScript-based automation bot helps you maximize your Microsoft Rewards points by automatically completing daily tasks, searches, quizzes, and promotional offers. Designed with sophisticated anti-detection measures and human-like behavior patterns to ensure safe, reliable operation.

✨ Key Features

• 🔍 Automated Searches — Desktop and mobile Bing searches with natural patterns
• 📅 Daily Activities — Quizzes, polls, daily sets, and punch cards
• 🤖 Human-like Behavior — Advanced humanization system to avoid detection
• 🛡️ Risk Management — Built-in ban detection and prediction with ML algorithms
• ⏰ Automatic Scheduling — Easy configuration for cron (Linux/Raspberry Pi) and Windows Task Scheduler
• 🔔 Notifications — Discord webhooks and NTFY push alerts
• 🐳 Docker Support — Easy containerized deployment
• 🔐 Multi-Account — Manage multiple accounts with parallel execution
• 🌐 Proxy Support — Optional proxy configuration for enhanced privacy

---

🚀 Quick Start

⚡ Prerequisites

• Node.js 20+ (v22 recommended) — Download here
• Git (optional) — Download here or download project as ZIP

🎯 3-Step Setup

1. Get the project:

   git clone https://github.com/Obsidian-wtf/Microsoft-Rewards-Bot.git
   cd Microsoft-Rewards-Bot
   

   Or download ZIP: Code → Download ZIP

2. Install dependencies:

   npm i
   

3. Create accounts & configure:

   # Use our account creator (recommended - earn +7,500 points/month!)
   npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE -y backup@gmail.com
   
   # Or use setup wizard
   npm run setup
   

📖 Need detailed instructions? See Getting Started Guide

---

📚 Documentation

For detailed configuration, advanced features, and troubleshooting, visit our comprehensive documentation:

👉 Complete Documentation

Quick Links

Topic	Description
Getting Started	Detailed installation and first-run guide
Configuration	Complete configuration options reference
Accounts & 2FA	Setting up accounts with TOTP authentication
Dashboard	🆕 Local web dashboard for monitoring and control
External Scheduling	Use OS schedulers for automation
Docker Deployment	Running in containers
Humanization	Anti-detection and natural behavior
Notifications	Discord webhooks and NTFY setup
Error Reporting	🆕 Automatic error reporting to help improve the project
Proxy Setup	Configuring proxies for privacy
Troubleshooting	Debug common issues and capture logs

---

📊 Dashboard (BETA)

Monitor and control your bot through a local web interface:

# Start dashboard separately
npm run dashboard

# Or enable auto-start in config.jsonc:
{
  "dashboard": {
    "enabled": true,
    "port": 3000
  }
}

Access at http://localhost:3000 to:

• 📈 View real-time points and account status
• 📋 Monitor live logs with WebSocket streaming
• 🔄 Manually sync individual accounts
• ⚙️ Edit configuration with automatic backup
• 📊 View historical run summaries and metrics

📖 Full Dashboard API Documentation

---

🆕 Account Creator (BETA)

Automatically create new Microsoft accounts with advanced security features:

# Interactive mode (asks everything)
npm run creator

# With referral link (earn rewards credit)
npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE

# Auto-accept mode (enables recovery + 2FA automatically)
npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE -y

# With specific recovery email (auto-detected, no flag needed!)
npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE -y backup@gmail.com

# Just recovery email, no referral
npm run creator -y myrecovery@gmail.com

✨ Features:

• 🎯 Language-independent — Works in any language
• 🔐 Strong passwords — Automatically generated (12-16 chars)
• 📧 Realistic emails — 200+ name database for natural-looking addresses
• 🎂 Natural birthdates — Random age 18-50 years old
• 🛡️ Recovery email — Optional backup email for account recovery
• 🔒 2FA support — TOTP authentication with Google Authenticator
• 🔑 TOTP secrets — Extracts and saves secret keys
• 💾 Complete backups — Saves all details including recovery codes
• 🤖 CAPTCHA support — Manual solving (human verification)
• <EFBFBD> Organized storage — Individual files per account

🎛️ Command Arguments (SIMPLIFIED!):

• <url> — Referral URL (auto-detected if starts with http)
• <email> — Recovery email (auto-detected if contains @)
• -y — Auto-accept mode (enables recovery + 2FA automatically)

That's it! No more confusing flags. 🎉

⚙️ How It Works:

Command	Recovery Email	2FA	Notes
npm run creator	❓ Prompts	❓ Prompts	Interactive mode
npm run creator -y	✅ Prompts for email	✅ Enabled	Auto-accept all
npm run creator -y backup@gmail.com	✅ Uses provided email	✅ Enabled	Full automation
npm run creator URL -y	✅ Prompts for email	✅ Enabled	With referral
npm run creator URL -y backup@gmail.com	✅ Uses provided email	✅ Enabled	Complete setup

📋 What happens:

1. Creates Microsoft account (email, password, birthdate, names)
2. Enrolls in Microsoft Rewards (if referral URL provided)
3. [Optional] Adds recovery email with verification
4. [Optional] Sets up 2FA with TOTP (Google Authenticator compatible)
5. Extracts and saves TOTP secret key and recovery code
6. Saves complete account info to accounts-created/ directory

🔐 Saved Information:

• Email and password
• Full name and birthdate
• Referral URL (if used)
• Recovery email (if added)
• TOTP secret key (for authenticator apps)
• 5-part recovery code (emergency access)

📖 Full Account Creator Guide

---

⏰ Automatic Scheduling

Configure automatic task scheduling directly from config.jsonc - perfect for Raspberry Pi!

{
  "scheduling": {
    "enabled": true,    // Just set this to true
    "type": "auto",     // Automatically detects Windows/Linux/Raspberry Pi
    "cron": {
      "schedule": "0 9 * * *"  // Raspberry Pi/Linux: Daily at 9 AM
    },
    "taskScheduler": {
      "schedule": "09:00"      // Windows: Daily at 9:00
    }
  }
}

Then simply run:

npm run start

The bot will automatically configure cron (Linux/Raspberry Pi) or Task Scheduler (Windows) for you!

📖 Full Scheduling Documentation

---

🐳 Docker Quick Start

For containerized deployment with built-in scheduling:

# Ensure accounts.jsonc and config.jsonc exist in src/
docker compose up -d

# View logs
docker logs -f microsoft-rewards-script

# Check status
docker compose ps

Container includes:

• ✅ Built-in cron scheduling
• ✅ Automatic timezone handling
• ✅ Random execution delays (anti-detection)
• ✅ Health checks

📖 Full Docker Guide

---

⚙️ Configuration Highlights

The script works great with default settings, but you can customize everything in src/config.jsonc:

{
  "search": {
    "useLocalQueries": false,     // Prioritize Google Trends API (recommended)
    "settings": {
      "useGeoLocaleQueries": true // Use account country for searches (FR, DE, JP, etc.)
    }
  },
  "queryDiversity": {
    "enabled": true,              // Mix multiple search sources
    "sources": ["google-trends", "reddit", "local-fallback"]
  },
  "humanization": {
    "enabled": true,              // Enable natural behavior patterns
    "stopOnBan": true             // Stop on ban detection
  },
  "workers": {
    "doDesktopSearch": true,      // Desktop Bing searches
    "doMobileSearch": true,       // Mobile Bing searches
    "doDailySet": true,           // Daily tasks and quizzes
    "doMorePromotions": true,     // Promotional offers
    "doPunchCards": true          // Multi-day challenges
  },
  "execution": {
    "clusters": 1,                // Parallel account processing
    "runOnZeroPoints": false      // Skip when no points available
  }
}

📖 Complete Configuration Guide

---

🎯 What Gets Automated

The script automatically completes:

• ✅ Desktop Searches — 30+ searches on Bing (desktop user-agent)
• ✅ Mobile Searches — 20+ searches on Bing (mobile user-agent)
• ✅ Daily Set — Quizzes, polls, and daily activities
• ✅ More Activities — Promotional tasks and special offers
• ✅ Punch Cards — Multi-day challenges and bonus tasks
• ✅ Daily Check-in — Simple check-in for bonus points
• ✅ Read to Earn — Article reading tasks

All while maintaining natural behavior patterns to minimize detection risk.

---

💡 Usage Tips

• Run regularly: Use cron, systemd timers, or Windows Task Scheduler (see docs)
• Use humanization: Always keep humanization.enabled: true for safety
• Monitor logs: Check for ban warnings and adjust settings if needed
• Multiple accounts: Use the clusters setting to run accounts in parallel
• Start small: Test with one account before scaling up
• Capture logs: Pipe output to a file or webhook for later review

---

✅ Tests

• npm run test: runs the node:test suite with ts-node to validate critical utilities.

---

🆘 Getting Help

• 💬 Join our Discord — Community support and updates
• 📖 Documentation Hub — Complete guides and references
• 🐛 Report Issues — Bug reports and feature requests
• 📧 Troubleshooting Guide — Debug common issues

---

⚠️ Disclaimer

Use at your own risk. This script automates interactions with Microsoft Rewards, which may violate Microsoft's Terms of Service. Using automation tools can result in:

• ⚠️ Account suspension or permanent ban
• 🚫 Loss of accumulated points and rewards
• 🔒 Restriction from future participation

This project is provided for educational and research purposes only. The developers and contributors:

• Are not responsible for any actions taken by Microsoft against your account
• Do not encourage violating terms of service
• Provide no guarantees regarding account safety

Use responsibly and at your own discretion.

---

📄 License

This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

You may:

• ✅ Use for personal, non-commercial purposes
• ✅ Modify the code for your own use
• ✅ Share with others (with same restrictions)
• ✅ Submit improvements via pull requests

You may NOT:

• ❌ Use for commercial purposes
• ❌ Sell or monetize this software
• ❌ Remove license/copyright notices

See LICENSE for complete terms.

---

🙏 Acknowledgments

• Built with Playwright and ReBrowser
• Thanks to all contributors
• Community support via Discord

---

🌟 Support the Project

If you find this project helpful:

• ⭐ Star the repository on GitHub
• 💬 Join our Discord community
• 🐛 Report bugs and suggest features
• 📖 Contribute to documentation

---

Made with ❤️ by the community

Documentation • Discord • Issues