skilld
All skills
resciencelab avatar

/domain-hunter

@2aedb75
by ReScience Labresciencelab/opc-skills1.8k stars
169

Search domains, compare prices, find promo codes, get purchase recommendations. Use when user wants to buy a domain, check domain prices, find domain deals, compare registrars, or search for .ai/.com domains.

Ask your Agent

Use this Skill: https://skilld.dev/gh/resciencelab/opc-skills/domain-hunter

This session only. Nothing lands on disk.

referencesspaceship-api.md

≈2.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

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

Scope Description
domains:read Read domain information
domains:write Manage domain settings
domains:transfer Domain transfer in/out
domains:billing Domain purchase and renewal
contacts:read Read contacts
contacts:write Save contacts
dnsrecords:read Read DNS records
dnsrecords:write Write DNS records
asyncoperations:read Query async operations

Rate Limits

Operation Limit
List domains 300 req / 300s per user
Check availability (batch) 30 req / 30s per user
Check availability (single) 5 req / 300s per domain
Get domain info 5 req / 300s per domain
Register domain 30 req / 30s per user
Update nameservers 5 req / 300s per domain
Async operations 60 req / 300s per user

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}" ...

Source: SKILL.md on GitHub

Third-party checks

4 warnings15d5 checks · Risk MEDIUM
  • Gen Agent Trust Hub15d

    The domain-hunter skill assists users in finding and purchasing domain names by suggesting names, checking availability, and comparing prices across registrars. It also searches social media for promotional codes and includes documentation for the Spaceship API. The skill introduces risks by accessing API credentials from the user's shell configuration files and processing untrusted data from social media platforms.

  • Socket15d

    1 alert: gptAnomaly

  • Snyk15d

    Risk: MEDIUM · 1 issue

  • Runlayer7mo

    5/5 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 2aedb75. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 12 hours ago.

Activeupdated 8 months ago

Topics

  • AI/ML
  • domain-registration
  • domain-search
  • price-comparison
  • promo-codes
  • registrar
  • whois
  • io
  • com

README badge

README badge for resciencelab/opc-skills/domain-hunter

What it does

Searches domain availability, compares prices across registrars like Spaceship and Namecheap, and finds promo codes via Twitter and Reddit. Helps users identify affordable domain names and select the best registrar for purchase, with specific guidance on premium TLDs like .ai and .io.

Generated from the current SKILL.md.

Frequently asked

Does this skill check domain availability automatically?
Yes. It uses WHOIS checks, registrar search pages, or bulk domain checkers (Namecheap, Dynadot) to verify availability before presenting suggestions to you.
Can I find promo codes for premium TLDs like .ai or .io?
Promo codes are rarely available for premium TLDs because wholesale costs are too high. The skill will search for them via Twitter and Reddit, but availability is unlikely.
Does this skill compare prices across multiple registrars?
Yes. It uses price comparison sites (tld-list.com, tldes.com, domaintyper.com) and web search to find current pricing across registrars like Spaceship, Cloudflare, Namecheap, and Porkbun.
What are the registration minimums for .ai domains?
The skill notes that .ai domains require a 2-year minimum registration, not annual.
Does this skill handle WHOIS privacy?
The skill documents that WHOIS privacy is free at most registrars (Cloudflare, Namecheap, Porkbun), but does not automate privacy settings—that is left to manual registrar checkout.

Generated from the current SKILL.md. These answers refresh after source changes.