/install domain-checker
Domain Checker
Check domain availability using whois + DNS cross-verification. Single source of truth for all domain availability queries.
Quick Start
Run the Python script (no system dependencies — no whois/dig CLI needed):
python3 scripts/check_domains.py example.com myproject.io brand.ai
Or pipe a list:
echo "foo.com bar.ai baz.io" | python3 scripts/check_domains.py
Legacy bash script (requires whois + dig CLI):
bash scripts/check_domains.sh example.com myproject.io brand.ai
Output Format
Each domain gets one of three verdicts:
| Symbol | Meaning | Confidence |
|---|---|---|
| ✅ AVAILABLE | whois says "not found" AND no DNS NS records | High |
| ❌ TAKEN | whois shows Creation Date OR DNS records exist | High |
| ⚠️ LIKELY TAKEN | Conflicting signals (whois unclear but DNS exists) | Medium |
| ❓ UNKNOWN | whois returned no data — verify manually | Low |
How It Works
Three independent signals are cross-verified:
- whois Creation Date — Most authoritative. If present, domain is taken.
- DNS NS records — Registered domains almost always have nameservers.
- DNS A records — Fallback signal for parked/active domains.
A domain is only marked AVAILABLE when whois explicitly says "not found" AND no DNS records exist. This eliminates false positives from unreliable whois web interfaces.
Important Notes
- Rate limiting: The script waits 1 second between queries to avoid whois server throttling. For large batches (>50), consider splitting into multiple runs.
- whois web interfaces are unreliable: Sites like whois.com often return stale/incorrect data. This script uses the
whoisCLI directly. - .ai TLD quirk: The .ai whois server sometimes returns sparse data. The script handles this by also checking DNS.
- Premium/aftermarket domains: A domain may be "available" in whois but listed at a premium price on registrars. The script cannot detect this — check the registrar for actual purchase price.
- Python script: No system dependencies — uses stdlib
socketfor whois (port 43) and DNS resolution. - Bash script (legacy): Requires
whoisanddigCLI tools (pre-installed on most Linux/macOS systems).
Batch Domain Brainstorming
When helping users brainstorm project names with domain checks, use this workflow:
- Generate 15-30 candidate names based on user criteria
- Run all candidates through the script in one batch
- Present only the AVAILABLE results with analysis
- Iterate on available candidates if needed
Example:
python3 scripts/check_domains.py myapp.com myapp.ai myapp.io coolname.com coolname.ai
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install domain-checker - After installation, invoke the skill by name or use
/domain-checker - Provide required inputs per the skill's parameter spec and get structured output
What is Domain Checker?
Check whether domain names are available for registration. Use when a user asks to verify domain availability, find unregistered domains, brainstorm project/... It is an AI Agent Skill for Claude Code / OpenClaw, with 396 downloads so far.
How do I install Domain Checker?
Run "/install domain-checker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Domain Checker free?
Yes, Domain Checker is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Domain Checker support?
Domain Checker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Domain Checker?
It is built and maintained by Yulong (@blueyi); the current version is v1.1.0.