Domain Hunter

Domain Hunter Skill

Help users find and purchase domain names at the best price.

Workflow

Step 1: Generate Domain Ideas & Check Availability

Based on the user's project description, generate 5-10 creative domain name suggestions.

Guidelines:

• Keep names short (under 15 characters)
• Make them memorable and brandable
• Consider: {action}{noun}, {noun}{suffix}, {prefix}{keyword}
• Common suffixes: app, io, hq, ly, ify, now, hub

CRITICAL: Always check availability before presenting domains to user!

Use one of these methods to verify availability:

Method 1: WHOIS check (most reliable)

# Check if domain is available via whois
whois {domain}.{tld} 2>/dev/null | grep -i "no match\|not found\|available\|no data found" && echo "AVAILABLE" || echo "TAKEN"

Method 2: Registrar search page Open the registrar's domain search in browser to verify:

open "https://www.spaceship.com/domains/?search={domain}.{tld}"

Method 3: Bulk check via Namecheap/Dynadot

• https://www.namecheap.com/domains/registration/results/?domain={domain}
• https://www.dynadot.com/domain/search?domain={domain}

IMPORTANT:

• Only present domains that are confirmed AVAILABLE
• Mark any uncertain domains with "(unverified)"
• Present suggestions to user and wait for confirmation before proceeding
• Ask user to pick their preferred options or provide feedback
• Only move to Step 2 after user approves domain name(s)

Step 2: Compare Prices

Use WebSearch to find current prices:

WebSearch: "cheapest .{tld} domain registrar 2026 site:tld-list.com"
WebSearch: ".{tld} domain price comparison tldes.com"

Key price comparison sites:

• tld-list.com/tld/{tld}
• tldes.com/{tld}
• domaintyper.com/{tld}-domain

Step 3: Find Promo Codes

Use Twitter skill to search registrar accounts:

cd <twitter_skill_directory>
python3 scripts/search_tweets.py "from:{registrar} promo code" --type Latest --limit 15
python3 scripts/search_tweets.py "{registrar} promo code coupon" --type Latest --limit 15

Use Reddit skill to search domain communities:

cd <reddit_skill_directory>
python3 scripts/search_posts.py "{registrar} promo code" --limit 15
python3 scripts/search_posts.py "{registrar} coupon discount" --subreddit Domains --limit 10

Major registrar Twitter handles:

• @spaceship, @Dynadot, @Namecheap, @Porkbun, @namesilo, @Cloudflare

Step 4: Recommend

Present final recommendation in this format:

## Recommendation

**Domain:** example.ai
**Best Registrar:** Spaceship
**Price:** $68.98/year (2-year minimum = $137.96)
**Promo Code:** None available for .ai
**Purchase Link:** https://www.spaceship.com/

### Price Comparison
| Registrar | Year 1 | Renewal | 2-Year Total |
|-----------|--------|---------|--------------|
| Spaceship | $68.98 | $68.98  | $137.96      |
| Cloudflare| $70.00 | $70.00  | $140.00      |
| Porkbun   | $71.40 | $72.40  | $143.80      |

Important Notes

1. Premium TLDs (.ai, .io) rarely have promo codes - wholesale costs are too high 2. .ai domains require 2-year minimum registration 3. Cloudflare offers at-cost pricing with no markup 4. Renewal prices often differ from registration - always check both 5. WHOIS privacy is free at most registrars (Cloudflare, Namecheap, Porkbun)

References

• references/registrars.md - Detailed registrar comparison
• references/spaceship-api.md - Spaceship API for automated domain operations

Domain Hunter Example: Finding a Domain for Auto Video Editing Project

This is a complete conversation example showing how the domain-hunter skill helps users find and purchase domain names at the best price.

---

Conversation

User

I am working on an auto video editing project. I need to buy a new domain. Please find one for me.

Assistant

I'll help you find a domain for your auto video editing project. Let me generate some creative domain name suggestions and check their availability.

Checking domain availability via WHOIS:

for domain in "autoedit.io" "clipcraft.io" "videoedit.ai" "cutflow.io" "autocuts.io" "editsnap.io" "vidflow.ai" "clipflow.io" "autoclipper.io" "smartcut.io"; do
  echo "Checking $domain..."
  result=$(whois "$domain" 2>/dev/null | grep -i "no match\|not found\|available\|no data found\|no entries found" | head -1)
  if [ -n "$result" ]; then
    echo "  -> LIKELY AVAILABLE"
  else
    echo "  -> LIKELY TAKEN"
  fi
done

Results - First Batch:

Checking autoedit.io...   -> LIKELY TAKEN
Checking clipcraft.io...  -> LIKELY TAKEN
Checking videoedit.ai...  -> LIKELY TAKEN
Checking cutflow.io...    -> LIKELY AVAILABLE
Checking autocuts.io...   -> LIKELY AVAILABLE
Checking editsnap.io...   -> LIKELY AVAILABLE
Checking vidflow.ai...    -> LIKELY TAKEN
Checking clipflow.io...   -> LIKELY TAKEN
Checking autoclipper.io...-> LIKELY AVAILABLE
Checking smartcut.io...   -> LIKELY TAKEN

Results - Second Batch:

Checking autovidz.io...   -> LIKELY AVAILABLE
Checking clipauto.io...   -> LIKELY AVAILABLE
Checking videotrim.ai...  -> LIKELY AVAILABLE
Checking cliphero.io...   -> LIKELY AVAILABLE
Checking quickclip.io...  -> LIKELY TAKEN
Checking autosnip.io...   -> LIKELY AVAILABLE
Checking vidauto.io...    -> LIKELY TAKEN
Checking clipmagic.io...  -> LIKELY TAKEN
Checking autorender.io... -> LIKELY TAKEN
Checking editbot.io...    -> LIKELY AVAILABLE

Here are the available domain suggestions for your auto video editing project:

Available Domains

My top picks: 1. cutflow.io - Short (7 chars), professional, memorable 2. autocuts.io - Clear purpose, good branding 3. videotrim.ai - .ai TLD fits AI/auto theme well

Which domain(s) would you like me to check prices for? Once you pick your favorites, I'll compare prices across registrars and look for promo codes.

---

User

cutflow.io looks good, I need to know where can I get the cheapest price to buy it? Also, is there any promo code?

Assistant

Activating Twitter skill and Reddit skill to search for promo codes...

Step 1: Web Search for Price Comparison

Fetched data from https://tld-list.com/tld/io showing current .io domain prices:

Step 2: Twitter Search for Promo Codes

python3 scripts/search_tweets.py "from:spaceship promo code" --type Latest --limit 10

Results from @spaceship:

tweets[6]{id,author,text,likes}:
  1994242486982561849,@spaceship,@MyBrandDomains Hello, thank you for the shout-out...
  1912951775230906514,@spaceship,@menjilx Feel free to use the SPSR86 promo code for the disc,1
  1823732844570542526,@spaceship,@DomainGoodness Yes, you are right. You can use this promo c,1

python3 scripts/search_tweets.py "from:Dynadot promo code" --type Latest --limit 10

Results from @Dynadot:

tweets[10]{id,author,text,likes}:
  1952815921958928524,@Dynadot,🚨 Transfer your .COM domains to Dynadot for just $10.49 with,25
  1922625449613562197,@Dynadot,@Bhanudbk @dynatodd We did have a .com promo code in April a,2
  1918277574255657371,@Dynadot,@DomainFrank Hi there @DomainFrank sorry we don't have a reg,0

python3 scripts/search_tweets.py "from:Namecheap promo code" --type Latest --limit 10

Results from @Namecheap:

tweets[10]{id,author,text,likes}:
  1943382216437834185,@Namecheap,@Umarkha69276826 Hi! If you are a new customer, you can get ,1
  1731983630761632149,@Namecheap,@bai_Dobri For new users, we've got our NEWCOM598 code at ht,3

Step 3: Reddit Search for Promo Codes

python3 scripts/search_posts.py "spaceship domain promo code" --subreddit Domains --limit 10

Results from r/Domains:

r/Domains/search(spaceship domain promo code)[10]{title,subreddit,score,comments}:
  Domain pricing question: Cloudflare vs Spaceship renewals,r/Domains,1,10
  Best godaddy promo code domain deals for first time buyers?,r/Domains,0,14
  Spaceship Buyer Hub,r/Domains,2,14
  Best registrar for a throwaway .com domain I need for just 1,r/Domains,5,4

---

Final Recommendation

Domain: cutflow.io

Price Comparison

Best Deal

Winner: Spaceship at $14.98/year (with promo code IO85)

• Promo Code: IO85 (85% off .io registration, limit 1 per customer)
• Free Features: DNS, Email Forwarding, WHOIS Privacy
• Renewal: $46.58/year (industry standard for .io)

Purchase Link: https://www.spaceship.com/

Alternative if renewal matters

Sav.com at $14.99/year with the cheapest renewal at $38.95/year - best 3-year value if you plan to keep the domain long-term.

---

Note: .io domains have high wholesale costs (~$45), so the first-year promos are significant discounts. Renewal prices are similar across registrars.

---

Key Takeaways

1. WHOIS checks are used to verify domain availability before presenting options 2. Price comparison from tld-list.com provides up-to-date registrar pricing 3. Twitter skill searches registrar accounts (@spaceship, @Dynadot, @Namecheap) for promo codes 4. Reddit skill searches r/Domains community for user-shared deals 5. Final recommendation includes best price, promo code, and purchase link

Domain Registrar Reference

Recommended Registrars

Price Tiers by TLD

Premium TLDs (rarely have promos)

• .ai - $65-80/year (Anguilla ccTLD, 2-year min)
• .io - $35-50/year (British Indian Ocean Territory)
• .co - $25-35/year (Colombia)

Standard TLDs

• .com - $9-14/year
• .net - $12-16/year
• .org - $10-14/year

Budget TLDs

• .xyz - $1-10/year
• .club - $1-5/year
• .site - $1-5/year

Registrar Purchase Links

Twitter Handles for Promo Search

@spaceship
@Dynadot
@Namecheap
@Porkbun
@namesilo
@Cloudflare
@GoDaddy

Reddit Communities

• r/Domains - General domain discussion
• r/webhosting - Hosting + domains
• r/Entrepreneur - Sometimes domain deals shared

Spaceship API Reference

API keys configured in ~/.zshrc:

• SPACESHIP_API_KEY
• SPACESHIP_API_SECRET

Base URL: https://spaceship.dev/api

Authentication

All requests require these headers:

-H "X-Api-Key: $SPACESHIP_API_KEY"
-H "X-Api-Secret: $SPACESHIP_API_SECRET"

Load environment variables:

export SPACESHIP_API_KEY="$(grep SPACESHIP_API_KEY ~/.zshrc | cut -d'"' -f2)"
export SPACESHIP_API_SECRET="$(grep SPACESHIP_API_SECRET ~/.zshrc | cut -d'"' -f2)"

Domains API

List Domains

curl -s -X GET "https://spaceship.dev/api/v1/domains?take=100&skip=0" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET"

Check Domain Availability (Batch)

curl -s -X POST "https://spaceship.dev/api/v1/domains/available" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["example.com", "test.ai"]}'

Response: result = "available" | "taken" | "reserved"

Check Single Domain Availability

curl -s -X GET "https://spaceship.dev/api/v1/domains/{domain}/available" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET"

Get Domain Info

curl -s -X GET "https://spaceship.dev/api/v1/domains/{domain}" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET"

Register Domain (Purchase)

curl -s -X POST "https://spaceship.dev/api/v1/domains/{domain}" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "autoRenew": true,
    "years": 1,
    "privacyProtection": {
      "level": "high",
      "userConsent": true
    },
    "contacts": {
      "registrant": "CONTACT_ID",
      "admin": "CONTACT_ID",
      "tech": "CONTACT_ID",
      "billing": "CONTACT_ID"
    }
  }'

Note: Returns 202 Accepted, poll async-operations for result

Update Nameservers (Configure to Cloudflare)

curl -s -X PUT "https://spaceship.dev/api/v1/domains/{domain}/nameservers" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "custom",
    "hosts": ["ns1.cloudflare.com", "ns2.cloudflare.com"]
  }'

Update Auto-Renewal

curl -s -X PUT "https://spaceship.dev/api/v1/domains/{domain}/autorenew" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"isEnabled": true}'

Renew Domain

curl -s -X POST "https://spaceship.dev/api/v1/domains/{domain}/renew" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"years": 1}'

Update Privacy Protection

curl -s -X PUT "https://spaceship.dev/api/v1/domains/{domain}/privacy" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "level": "high",
    "userConsent": true
  }'

Levels: "high" | "medium" | "none"

Update Domain Contacts

curl -s -X PUT "https://spaceship.dev/api/v1/domains/{domain}/contacts" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "registrant": "CONTACT_ID",
    "admin": "CONTACT_ID",
    "tech": "CONTACT_ID",
    "billing": "CONTACT_ID"
  }'

Get Auth Code (for Transfer Out)

curl -s -X GET "https://spaceship.dev/api/v1/domains/{domain}/auth-code" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET"

Update Transfer Lock

curl -s -X PUT "https://spaceship.dev/api/v1/domains/{domain}/transfer-lock" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"isEnabled": true}'

Transfer In Domain

curl -s -X POST "https://spaceship.dev/api/v1/domains/{domain}/transfer" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "authCode": "AUTH_CODE_FROM_CURRENT_REGISTRAR",
    "autoRenew": true,
    "privacyProtection": {
      "level": "high",
      "userConsent": true
    },
    "contacts": {
      "registrant": "CONTACT_ID",
      "admin": "CONTACT_ID",
      "tech": "CONTACT_ID",
      "billing": "CONTACT_ID"
    }
  }'

Contacts API

Save Contact

curl -s -X PUT "https://spaceship.dev/api/v1/contacts/{contactId}" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "organization": "Company Inc",
    "email": "john@example.com",
    "phone": "+1.5551234567",
    "address1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94102",
    "country": "US"
  }'

Get Contact

curl -s -X GET "https://spaceship.dev/api/v1/contacts/{contactId}" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET"

DNS Records API

Get DNS Records

curl -s -X GET "https://spaceship.dev/api/v1/dns-records/{domain}?take=100&skip=0" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET"

Save DNS Records

curl -s -X PUT "https://spaceship.dev/api/v1/dns-records/{domain}" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"type": "A", "name": "@", "address": "1.2.3.4", "ttl": 3600},
      {"type": "CNAME", "name": "www", "target": "example.com", "ttl": 3600},
      {"type": "TXT", "name": "@", "content": "v=spf1 ...", "ttl": 3600},
      {"type": "MX", "name": "@", "mailHost": "mail.example.com", "priority": 10, "ttl": 3600}
    ]
  }'

Delete DNS Records

curl -s -X DELETE "https://spaceship.dev/api/v1/dns-records/{domain}" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"type": "A", "name": "@", "address": "1.2.3.4"}
    ]
  }'

Async Operations

Domain registration, transfer, etc. are async operations, returning spaceship-async-operationid header.

Get Operation Status

curl -s -X GET "https://spaceship.dev/api/v1/async-operations/{operationId}" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET"

Status: "pending" | "success" | "failed"

API Permissions

Rate Limits

Common Workflows

1. Purchase Domain + Configure Cloudflare NS

# 1. Check availability
curl -s -X GET "https://spaceship.dev/api/v1/domains/example.com/available" ...

# 2. Get existing contact ID from another domain
curl -s -X GET "https://spaceship.dev/api/v1/domains?take=1&skip=0" ... | jq '.items[0].contacts.registrant'

# 3. Register domain
curl -s -X POST "https://spaceship.dev/api/v1/domains/example.com" ... -d '{...}'
# Note the operationId from response header

# 4. Poll for completion
curl -s -X GET "https://spaceship.dev/api/v1/async-operations/{operationId}" ...

# 5. Update nameservers to Cloudflare
curl -s -X PUT "https://spaceship.dev/api/v1/domains/example.com/nameservers" \
  ... -d '{"provider": "custom", "hosts": ["ns1.cloudflare.com", "ns2.cloudflare.com"]}'

2. Transfer Domain to Spaceship

# 1. Get auth code from current registrar
# 2. Unlock domain at current registrar
# 3. Initiate transfer
curl -s -X POST "https://spaceship.dev/api/v1/domains/example.com/transfer" ...

# 4. Poll async operation for status
curl -s -X GET "https://spaceship.dev/api/v1/async-operations/{operationId}" ...