domainstorm 0.3.1 → 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/SKILL.md +75 -0
- package/package.json +2 -1
package/SKILL.md
ADDED
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: domainstorm
|
|
3
|
+
description: Brainstorm and check domain name availability from the terminal. Use when the user asks to find available domains, brainstorm domain names, check if a domain is taken, or needs naming ideas for a project, startup, product, or tool. Also use when domain shopping, comparing TLDs, or building a list of available domains for purchase.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Domainstorm
|
|
7
|
+
|
|
8
|
+
Domain brainstorming and availability checking via CLI. Zero install — runs via `npx`.
|
|
9
|
+
|
|
10
|
+
## Quick Start
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
# Brainstorm + check availability
|
|
14
|
+
npx domainstorm --brainstorm "seed words here" --tld com --only-available --table
|
|
15
|
+
|
|
16
|
+
# Check specific domains
|
|
17
|
+
npx domainstorm example.com coolname.xyz agent.md
|
|
18
|
+
|
|
19
|
+
# Check from file
|
|
20
|
+
npx domainstorm --input domains.txt --output results.csv
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Key Flags
|
|
24
|
+
|
|
25
|
+
| Flag | Purpose | Default |
|
|
26
|
+
|------|---------|---------|
|
|
27
|
+
| `--brainstorm "seeds"` | Generate domain ideas from seed words | — |
|
|
28
|
+
| `--tld <tld>` | Default TLD for bare labels | `md` |
|
|
29
|
+
| `--only-available` | Show only available domains | off |
|
|
30
|
+
| `--table` | Structured table output | off |
|
|
31
|
+
| `--plain` | Machine-friendly TSV output | off |
|
|
32
|
+
| `--max-suggestions <n>` | Max brainstormed candidates | `120` |
|
|
33
|
+
| `--input <file>` | Read domains from file (one per line) | — |
|
|
34
|
+
| `--output <file>` | Export results to CSV | — |
|
|
35
|
+
| `--server <host>` | WHOIS server override (e.g. `whois.nic.md`) | auto |
|
|
36
|
+
| `--dns-prefilter` | DNS pre-check before WHOIS (faster) | off |
|
|
37
|
+
| `--concurrency <n>` | Parallel WHOIS requests | `2` |
|
|
38
|
+
| `--raw` | Include WHOIS snippet in output | off |
|
|
39
|
+
|
|
40
|
+
## Output Format
|
|
41
|
+
|
|
42
|
+
Each domain returns:
|
|
43
|
+
- **Verdict**: `✅ AVAILABLE`, `❌ TAKEN`, or `⚠️ UNKNOWN`
|
|
44
|
+
- **Domain**: the checked domain
|
|
45
|
+
- **Whois**: `registered`, `likely_available`, or `unknown`
|
|
46
|
+
- **Risk**: `low` or `high_tm_risk`
|
|
47
|
+
- **Story**: brainstorm narrative (e.g. "Two-seed compound", "Seed acronym")
|
|
48
|
+
|
|
49
|
+
Summary line: `✅ X available, ❌ Y taken, ⚠️ Z unknown.`
|
|
50
|
+
|
|
51
|
+
## Common Patterns
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
# .com domains for a startup idea
|
|
55
|
+
npx domainstorm --brainstorm "fintech payments" --tld com --only-available --table
|
|
56
|
+
|
|
57
|
+
# .md domains (agent/dev ecosystem)
|
|
58
|
+
npx domainstorm --brainstorm "agent mcp runtime" --tld md --server whois.nic.md --only-available --table
|
|
59
|
+
|
|
60
|
+
# .xyz domains
|
|
61
|
+
npx domainstorm --brainstorm "crypto defi wallet" --tld xyz --only-available --table
|
|
62
|
+
|
|
63
|
+
# Check a single domain
|
|
64
|
+
npx domainstorm coolproject.com
|
|
65
|
+
|
|
66
|
+
# Bulk check from file, export CSV
|
|
67
|
+
npx domainstorm --input candidates.txt --output results.csv --dns-prefilter
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Notes
|
|
71
|
+
|
|
72
|
+
- WHOIS results are heuristic — always confirm at registrar checkout before purchasing.
|
|
73
|
+
- Registries rate-limit bulk lookups. Retry `⚠️ UNKNOWN` results after a cooldown.
|
|
74
|
+
- Use `--dns-prefilter` for faster checks (skips WHOIS for domains that resolve via DNS).
|
|
75
|
+
- No API keys needed. No config. Just `npx`.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "domainstorm",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.2",
|
|
4
4
|
"description": "Brainstorm and check domain names in one command.",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
"files": [
|
|
19
19
|
"check-domains.mjs",
|
|
20
20
|
"agent-candidates.txt",
|
|
21
|
+
"SKILL.md",
|
|
21
22
|
"README.md"
|
|
22
23
|
],
|
|
23
24
|
"scripts": {
|