Beast Domain Checker

A fast, beautiful bulk domain availability checker powered by Namecheap Beast Mode automation using Puppeteer.

Features

• Bulk Checking - Check up to 1000 domains at once
• Multiple Input Methods - Upload CSV/TXT or paste directly
• Favorites System - Save domains with prices for later
• Export Results - Download as CSV
• Real-time Stats - See available, taken, and premium counts
• Modern UI - Dark theme with gradient accents

Quick Start

🚀 Production Deployment

For cloud deployment (Vercel, Railway, Render, etc.), see DEPLOYMENT.md

⚠️ Important: Vercel deployment requires Pro plan ($20/mo) for extended function timeout.

Docker Compose (Recommended for Self-Hosting)

git clone https://github.com/YOUR_USERNAME/beast-domain-checker.git
cd beast-domain-checker
docker compose up -d

Docker

# Build image
docker build -t beast-domain-checker .

# Run container
docker run -d -p 6006:6006 --name beast-domain-checker beast-domain-checker

# Stop container
docker stop beast-domain-checker

# Remove container
docker rm beast-domain-checker

Open http://localhost:6006 in your browser.

Manual Installation

# Install dependencies (Puppeteer will download Chromium automatically)
npm install

# Start development server
npm run dev

Note: Puppeteer automatically downloads a compatible Chromium browser during npm install. No additional installation steps required!

Usage

Web Interface

Upload File

Create a CSV or TXT file with one domain per line:

example.com
mysite.dev
awesome.io

Paste Domains

Paste domains directly in the textarea, one per line.

Save Favorites

Click "Add to Favorites" on any result to save it for later.

CLI Mode

Check domains directly from the command line with hacker-style real-time logging!

Installation

# Clone and install dependencies
git clone <your-repo-url>
cd beast-domain-checker
npm install

Usage

Option 1: Check from a file

npm run cli domains.txt

Create domains.txt with one domain per line:

example.com
mysite.dev
awesome.io

Option 2: Check domains directly

npm run cli -- --domains example.com test.dev awesome.io

Option 3: Custom output file

npm run cli domains.txt --output my-results.csv

Show help:

npm run cli -- --help

CLI Features

• 🎨 ASCII Art Banner - Beautiful BEAST logo on startup
• 🚀 Real-Time Hacker Logs - Watch the scan progress with tactical messages
• 🎯 Color-Coded Output - Green (available), Yellow (premium), Red (taken)
• ⚡ Fast Automation - Headless Chromium with Puppeteer
• 💾 Auto CSV Export - Results saved automatically to results.csv
• 📊 Detailed Statistics - Summary with available/premium/taken counts
• 🔍 Full Transparency - See every step: connection, upload, scan, extraction

Example Output

Supported File Formats

• TXT - One domain per line
• CSV - One domain per line (automatically detected)

Notes

• Maximum 1000 domains per run
• Processing time: ~1-2 minutes for 100 domains
• Results exported to results.csv by default
• Lines starting with # are treated as comments

Project Structure

beast-domain-checker/
├── src/
│   ├── lib/
│   │   ├── domainChecker.ts   # Puppeteer automation
│   │   ├── csvParser.ts       # File parsing
│   │   └── storage.ts         # Data persistence
│   ├── pages/
│   │   ├── index.astro        # Main UI
│   │   └── api/
│   │       ├── check-domains.ts
│   │       └── favorites.ts
│   └── styles/
│       └── global.css
├── public/
├── Dockerfile                 # Docker image definition
├── docker-compose.yml         # Docker Compose configuration
├── astro.config.mjs
├── tailwind.config.mjs
└── package.json

Tech Stack

• Astro - Web framework
• Puppeteer - Headless Chrome automation
• Tailwind CSS - Styling
• TypeScript - Type safety
• Docker - Containerization

Configuration

Port

Edit astro.config.mjs to change the default port (6006):

export default defineConfig({
  server: { port: 3000 }
});

Scripts

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT

Disclaimer

This tool automates Namecheap's Beast Mode for domain checking. Use responsibly and in accordance with Namecheap's terms of service.