clawdaddy

# ClawDaddy - AI-Friendly Domain Registrar

The world's #1 AI-friendly domain registrar. Check availability, purchase domains, configure DNS, and manage nameservers.

**Base URL:** `https://clawdaddy.app`

No CAPTCHAs. No signup required for lookups. Bearer tokens for management.

---

## Quick Reference

| Task | Endpoint | Auth |
|------|----------|------|
| Check availability | `GET /api/lookup/{domain}` | None |
| Get purchase quote | `GET /api/purchase/{domain}/quote` | None |
| Purchase domain | `POST /api/purchase/{domain}?method=x402\|stripe` | None |
| Manage domain | `GET /api/manage/{domain}` | Bearer token |
| Configure DNS | `POST /api/manage/{domain}/dns` | Bearer token |
| Update nameservers | `PUT /api/manage/{domain}/nameservers` | Bearer token |
| Recover token | `POST /api/recover` | None |

---

## 1. Check Domain Availability

**When:** User asks "Is example.com available?" or "Check if mycoolapp.io is taken"

```
GET https://clawdaddy.app/api/lookup/example.com
```

### JSON Response

```json
{
  "fqdn": "example.com",
  "available": true,
  "status": "available",
  "premium": false,
  "price": {
    "amount": 12.99,
    "currency": "USD",
    "period": "year"
  },
  "checked_at": "2026-01-15T10:30:00.000Z",
  "source": "namecom",
  "cache": { "hit": false, "ttl_seconds": 120 }
}
```

### TXT Response

```
GET https://clawdaddy.app/api/lookup/example.com?format=txt
```

```
fqdn=example.com
available=true
status=available
premium=false
price_amount=12.99
price_currency=USD
checked_at=2026-01-15T10:30:00Z
```

### Status Values

| Status | `available` | Meaning |
|--------|-------------|---------|
| `available` | `true` | Can be registered |
| `registered` | `false` | Already taken |
| `unknown` | `false` | Error/timeout |

**Key:** The `available` field is ALWAYS boolean (`true`/`false`), never undefined.

---

## 2. Purchase a Domain

### Step 1: Get Quote

**When:** User wants to buy a domain, get the price first.

```
GET https://clawdaddy.a...

# ClawDaddy Skill for ClawhHub

A skill for AI agents to check, purchase, and manage domains using [ClawDaddy](https://clawdaddy.app) - the world's #1 AI-friendly domain registrar.

## What It Does

- **Check availability** - `GET /api/lookup/{domain}`
- **Purchase domains** - x402 (USDC on Base) or Stripe (cards)
- **Configure DNS** - A, AAAA, CNAME, MX, TXT, NS, SRV records
- **Update nameservers** - Point to Cloudflare, Vercel, AWS, etc.
- **Manage settings** - Lock/unlock, auto-renew, transfer out

## Publishing to ClawhHub

```bash
# Install CLI
npm install -g clawdbot@latest

# Login via GitHub
clawhub login

# Publish (from this directory)
clawhub publish . \
  --slug clawdaddy \
  --name "ClawDaddy" \
  --version 1.0.0 \
  --tags latest
```

## Installing the Skill

```bash
clawhub install clawdaddy
```

## API Endpoints

### Lookups (No Auth)

| Endpoint | Purpose |
|----------|---------|
| `/api/lookup/{domain}` | Check availability (JSON) |
| `/api/lookup/{domain}?format=txt` | Check availability (TXT) |
| `/api/purchase/{domain}/quote` | Get purchase quote |
| `/api/purchase/{domain}?method=x402` | Buy with USDC |
| `/api/purchase/{domain}?method=stripe` | Buy with card |

### Management (Bearer Token Required)

| Endpoint | Purpose |
|----------|---------|
| `/api/manage/{domain}` | Domain overview |
| `/api/manage/{domain}/dns` | DNS records (CRUD) |
| `/api/manage/{domain}/nameservers` | Update nameservers |
| `/api/manage/{domain}/settings` | Domain settings |
| `/api/manage/{domain}/transfer` | Transfer out |
| `/api/recover` | Token recovery |

## Why ClawDaddy?

Traditional registrars (GoDaddy, Namecheap) block AI agents with CAPTCHAs, WAFs, and anti-bot measures. ClawDaddy provides:

- **No CAPTCHAs** - Just HTTP requests
- **No signup** - Lookups work immediately
- **Proper API responses** - JSON with correct Content-Type
- **AI-native payments** - x402 protocol (USDC on Base)
- **Bearer token auth** - Simple management tokens
- **Real-time data...