domain-searchlisted
Install: claude install-skill thattimc/skills
# Domain Search
Brainstorm brandable names and check which domains are actually available to register.
## How availability is checked: RDAP (not WHOIS, not a paid API)
Availability is determined with **RDAP** — the official IETF successor to WHOIS (RFC 9082/9083).
Query `https://rdap.org/domain/<fqdn>`, which routes to the responsible registry and returns:
- **HTTP 404 → AVAILABLE** (no registration record exists)
- **HTTP 200 → TAKEN** (a registration record exists)
- **anything else → UNKNOWN** (TLD has no RDAP server)
rdap.org throttles bursts, so the script retries `429`/`5xx`/network failures up to 3× with
backoff and pauses ~0.2s between domains (`RDAP_THROTTLE` env var). Without that, transient
rate-limiting shows up as `UNKNOWN` and quietly hides real answers in a large batch.
This is authoritative and free. It is more reliable than scraping Instant Domain Search /
GoDaddy, whose public endpoints change and rate-limit. RDAP tells you *registered or not*; it
does **not** price premium/reserved names — confirm the final price at a registrar.
### Caveats (state these when relevant)
- **Not all TLDs publish RDAP.** `.io` historically had no RDAP, and some ccTLDs still don't.
`UNKNOWN` means "couldn't determine" — never report it as available.
- `.com`, `.ai`, `.net`, `.org`, `.app`, `.dev`, `.co` work well via RDAP.
- An RDAP-available name can still be a **premium** listing (high price). Verify at checkout.
## The script
`scripts/check-domains.sh` — batch chec