DomainHunter CLI

A free, fast, pattern-based domain discovery tool for hand-registering valuable .com/.ai domains.

Overview

DomainHunter CLI is a command-line tool that automatically generates, scores, and checks availability of large batches of 4–6 letter domains (brandables, pronounceables, pattern-based).

The tool uses only free features, free APIs, and offline logic, except for AI scoring using OpenRouter.

Primary goal: find hand-reg gems before anyone else.

Installation

npm install -g domainhunter-cli

Or run without installation:

npx domainhunter-cli

Features

1. Domain Generator

• Supports 4-6 letter domains
• Patterns: CVCV, CVVC, VCCV, Random pronounceable
• Custom input wordlists
• Include/exclude letters
• Max output: configurable (default 1000)

2. Availability Checker

• Uses DNS-over-HTTPS (Cloudflare DoH)
• Checks A, NS, MX records
• Parallel/async checking
• Caching for performance
• Supports checking single domains or files with domains

3. WHOIS Checker

• Raw TCP WHOIS queries
• Server: whois.verisign-grs.com
• Parses creation date, expiration date, registrar
• Only runs when explicitly requested or domain is taken

4. Brandability Scoring

• Scores domains from 0–100 based on:
  • Length bonus
  • Vowel-to-consonant balance
  • Pattern bonus (CVCV etc.)
  • Phonetic smoothness
  • Absence of repeated ugly letters (qq, xx, zz)
  • Startup-friendly endings (ly, io, ai, ora, ina)

5. AI Scoring (Optional)

• Uses OpenRouter API with the user's key
• Rates domains for brandability, startup fit, memorability, tech vibe
• Set OPENROUTER_API_KEY environment variable to enable

6. Exporters

• CSV format
• JSON format
• Pretty table in terminal

7. Local Caching

• Caches DNS results, AI scores, WHOIS lookups
• Uses a simple JSON file

8. Watch Mode

• Automatically reruns generator + checker every X minutes
• Highlights available domains that meet score threshold
• Optional desktop notifications

Usage

Generate Domains

# Generate domains with CVCV pattern
domainhunter generate --length 5 --pattern CVCV --max 5000

# Generate domains from a custom wordlist
domainhunter generate --wordlist words.txt

# Save generated domains to a file for later processing
domainhunter generate --pattern CVCV --max 1000 --save mydomains.txt

# Apply filters
domainhunter generate --pattern CVCV --no-ugly --starts-with "a" --ends-with "e"

Check Domain Availability

# Check availability for domains in a file
domainhunter check domains.txt

# Check a single domain
domainhunter check google.com

# Only show available domains
domainhunter check domains.txt --only-available

# Include WHOIS data for taken domains
domainhunter check domains.txt --whois

Scan Domains

# Scan domains with scoring
domainhunter scan domains.txt --score-min 70

# Include AI scoring
domainhunter scan domains.txt --score-min 70 --ai-score

# Apply filters
domainhunter scan domains.txt --length 4-6 --pattern CVCV --only-available

Watch Mode

# Watch for new available domains every 30 minutes
domainhunter watch --interval 30 --length 5 --pattern CVCV

# Watch with a minimum score threshold
domainhunter watch --interval 60 --pattern CVCV --score-min 75

Options

• --length <length>: Length of domains (4-6), or range like "4-6"
• --pattern <pattern>: Pattern for generation (CVCV, CVVC, VCCV, random)
• --max <max>: Maximum number of domains to generate
• --wordlist <file>: Custom wordlist file path
• --starts-with <letters>: Domains must start with these letters
• --ends-with <letters>: Domains must end with these letters
• --contains <letters>: Domains must contain these letters
• --exclude <letters>: Domains must not contain these letters
• --score-min <score>: Minimum brandability score
• --only-available: Only output available domains
• --ai-score: Include AI scoring
• --whois: Include WHOIS lookup
• --no-ugly: Exclude domains with "q", "x", "z", "k" unless forced
• --save <file>: Save generated domains to a file (for generate command)

Environment Variables

• OPENROUTER_API_KEY: API key for OpenRouter (for AI scoring)

Output Format

Standard table output:

Rank | Domain     | Score | AI | Available | Notes
1    | ucuvo.com  | 82    | 8.5 | yes       | clean CVCVC
2    | ipefe.com  | 77    | 7.9 | yes       | balanced vowels

Development

To run in development:

git clone <repository>
cd domainhunt
npm install
node index.js

License

MIT