findurlink
v1.2.2
Published
Local DNS API server for findur.link — dig + whois domain availability checks
Downloads
459
Maintainers
Readme
findurlink
Local DNS API server for findur.link — runs dig + whois lookups for accurate domain availability checking.
Quick Start
npx findurlink
# or
bunx findurlinkThen open findur.link, go to Settings (in the filter sidebar), and select Local API mode.
Requirements
- Node.js >= 18 or Bun >= 1.0
dig(fromdnsutils/bind-tools)whois
Install dependencies
# Debian/Ubuntu
apt install dnsutils whois
# macOS
brew install bind whois
# Termux
pkg install dnsutils whoisOptions
| Env Variable | Default | Description |
|---|---|---|
| PORT | 3001 | Server port |
| CORS_ORIGIN | * | Allowed CORS origin |
API Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /api/stream | SSE streaming domain check |
| POST | /api/check | Batch domain check (JSON response) |
| GET | /api/whois?domain=x | Whois detail lookup |
| GET | /api/pricing | TLD pricing (Porkbun, cached 1hr) |
| GET | /api/health | Health check |
How It Works
- dig checks DNS status (NXDOMAIN = potentially available, NOERROR = taken)
- whois confirms availability for NXDOMAIN domains (with retry + rate limiting)
- Results are cached for 15 minutes to avoid hammering DNS/whois servers
License
MIT
