gadiguibou / rdapcheck

A simple RDAP library and command-line tool to check domain name availability in bulk. https://deno.land/x/rdapcheck

rdapcheck

A simple library and command-line tool to check domain name availability in bulk using the RDAP protocol, a simple protocol meant to replace WHOIS.

This module is also available on deno.land/x.

Installation

Using Deno

Run once using:

deno run --allow-net https://deno.land/x/rdapcheck/cmd.ts

Compile the client into a portable executable using:

deno compile -o rdapcheck --allow-net https://deno.land/x/rdapcheck/cmd.ts

Install the client using:

deno install -n rdapcheck --allow-net https://deno.land/x/rdapcheck/cmd.ts

Manually

Binary executables are available for the latest release.

Usage

rdapcheck [OPTIONS] DOMAINS...

The available options are:

• -q or --quiet: Only print the names of the domains that are available
• -p or --progress: Print the number of domains processed so far
• -c or --chunk-size: The number of domains to process in parallel. Set to 10 by default

DOMAIN can be a domain name or a pattern with wildcards that rdapcheck will fill in with every possible value.

The available wildcards are:

• *: Matches any letter, number or hyphen, "-"
• ?: Matches any letter
• #: Matches any number

Examples

Check the availability of a single domain

$ rdapcheck johndoe.xyz
johndoe.xyz is not available

Check the availability of multiple domains with a single command

$ rdapcheck aaa.net bbb.org asldkfjal.com johndoe.xyz
aaa.net is not available
bbb.org is not available
asldkfjal.com is available
johndoe.xyz is not available

Only print the names of the domains that are available

$ rdapcheck -q aaa.net bbb.org asldkfjal.com johndoe.xyz
asldkfjal.com

Check the availability of all domains that match a list of patterns

$ rdapcheck -q 'ex?mple.com' 'johndoe#.net'
exbmple.com
excmple.com
exdmple.com
exfmple.com
...
exrmple.com
extmple.com
exumple.com
johndoe0.com
johndoe1.com
...
johndoe5.com
johndoe6.com
johndoe8.com
johndoe9.com

Sources

This tool was completed over the course of one afternoon by referring to the following sources:

• ICANN RDAP overview
• ICANN lookup tool
• RFC 7483
• ARIN page on Whois and the RDAP protocol
• The IANA RDAP bootstrapping registry
• RFC 8605
• RFC 8977
• RFC 9082
• RFC 9083
• RFC 7484

For more information on the latest standardization efforts on RDAP, see the RFC Editor's RDAP page.

rdapcheck's Issues

installs as "cmd" not good

When I install the binary it installs it as "cmd"

i think you need to do something to get it to install as rdapcheck instead.

Generated domains don't comply with RFC

Hi, your project is very helpful, but I still want to point out a few flaws:

1. Refer to the RFC 3696, If the hyphen is used, it is not permitted to appear at either the beginning or end of a label.
2. Although the program runs very fast, it often considers registered domains to be available, I'm not sure if this is a programming problem or the rdap data. As an example: check ??.tv