Domain availability API built for AI agents. Check single domains, explore names across .com/.io/.ai/.dev/etc, filter by budget, get smart suggestions. Returns proper JSON/TXT with correct Content-Type headers.

# ClawDaddy - AI-Friendly Domain Registrar

全球排名第一的 AI 友好型域名注册商。检查可用性、购买域名、配置 DNS 以及管理域名服务器。

**基础 URL：** `https://clawdaddy.app`

无 CAPTCHA 验证。查询无需注册。管理操作使用 Bearer 令牌。

---

## 快速参考

| 任务 | 端点 | 认证 | |------|----------|------| | 检查可用性 | `GET /api/lookup/{domain}` | 无 | | 构思可用域名 | `POST /api/brainstorm` | 无 | | 获取购买报价 | `GET /api/purchase/{domain}/quote` | 无 | | 购买域名 | `POST /api/purchase/{domain}?method=x402\|stripe` | 无 | | 管理域名 | `GET /api/manage/{domain}` | Bearer 令牌 | | 配置 DNS | `POST /api/manage/{domain}/dns` | Bearer 令牌 | | 更新域名服务器 | `PUT /api/manage/{domain}/nameservers` | Bearer 令牌 | | 恢复令牌 | `POST /api/recover` | 无 |

---

## 1. 检查域名可用性

**何时使用：** 用户询问“example.com 可用吗？”或“检查 mycoolapp.io 是否已被注册”

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

### JSON 响应

```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 响应

``` 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 ```

### 状态值

| 状态 | `available` | 含义 | |--------|-------------|---------| | `available` | `true` | 可以注册 | | `registered` | `false` | 已被占用 | | `unknown` | `false` | 错误/超时 |

**注意：** `available` 字段**始终**为布尔值（`true`/`false`），绝不为 undefined。

---

## 2. 构思可用域名

当您需要快速获取**可用**域名列表时使用此接口。

``` POST https://clawdaddy.app/api/brainstorm ```

### 请求示例

```json { "prompt": "AI tool for async standups", "count": 8, "mode": "balanced", "max_price": 30, "tlds": ["com", "io", "ai"], "style": "brandable", "must_include": ["standup"] } ```

### 模式

- `fast`：仅缓存（最低延迟） - `balanced`：缓存 + 实时 Name.com 搜索 - `deep`：增加生成的检查以提供更多创意

---

## 3. 购买域名

### 步骤 1：获取报价

**何时使用：** 用户想要购买域名，先获取价格。

``` GET https://clawdaddy.app/api/purchase/example.com/quote ```

```json { "domain": "example.com", "available": true, "priceUsd": 12.99, "marginUsd": 2.00, "totalUsd": 14.99, "validUntil": "2026-01-15T10:35:00.000Z", "paymentMethods": { "x402": { "enabled": true, "currency": "USDC", "network": "base" }, "stripe": { "enabled": true, "currency": "USD" } } } ```

### 步骤 2a：通过 x402 购买（Base 链上的 USDC）

**适用对象：** 拥有加密钱包的 AI 代理

``` POST https://clawdaddy.app/api/purchase/example.com?method=x402 ```

首次请求返回 HTTP 402 以及支付要求：

```json { "error": "Payment Required", "x402": { "version": "2.0", "accepts": [{ "scheme": "exact", "network": "eip155:8453", "maxAmountRequired": "14990000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x..." }] } } ```

在 Base 链上支付 USDC 后，使用支付证明重试：

``` POST https://clawdaddy.app/api/purchase/example.com?method=x402 x-payment: <payment_proof_from_x402> ```

### 步骤 2b：通过 Stripe 购买（银行卡）

**适用对象：** 人类用户或没有加密货币的代理

``` POST https://clawdaddy.app/api/purchase/example.com?method=stripe Content-Type: application/json

{ "email": "[email protected]" } ```

返回 Stripe 结账 URL：

```json { "checkoutUrl": "https://checkout.stripe.com/...", "sessionId": "cs_..." } ```

### 成功响应（两种方法）

```json { "success": true, "domain": "example.com", "registrationId": "12345", "expiresAt": "2027-01-15T10:30:00.000Z", "nameservers": ["ns1.name.com", "ns2.name.com"], "managementToken": "clwd_abc123xyz...", "manageUrl": "https://clawdaddy.app/api/manage/example.com" } ```

**关键：** 请立即保存 `managementToken`！所有管理操作都需要它，且不通过恢复流程无法找回。

---

## 4. 域名管理

所有管理端点都需要 Authorization 请求头：

``` Authorization: Bearer clwd_your_management_token ```

### 获取域名概览

``` GET https://clawdaddy.app/api/manage/example.com Authorization: Bearer clwd_abc123... ```

```json { "domain": "example.com", "purchasedAt": "2026-01-15T10:30:00.000Z", "expiresAt": "2027-01-15T10:30:00.000Z", "nameservers": ["ns1.name.com", "ns2.name.com"], "settings": { "locked": true, "autorenewEnabled": false, "privacyEnabled": true } } ```

### DNS 记录

**列出所有记录：** ``` GET /api/manage/{domain}/dns ```

**创建记录：** ``` POST /api/manage/{domain}/dns Content-Type: application/json

{ "host": "@", "type": "A", "answer": "1.2.3.4", "ttl": 300 } ```

**更新记录：** ``` PUT /api/manage/{domain}/dns?id=123 Content-Type: application/json

{ "answer": "5.6.7.8", "ttl": 600 } ```

**删除记录：** ``` DELETE /api/manage/{domain}/dns?id=123 ```

**支持的记录类型：** `A`、`AAAA`、`CNAME`、`MX`、`TXT`、`NS`、`SRV`

### 常见 DNS 配置

**指向服务器（A 记录）：** ```json {"host": "@", "type": "A", "answer": "123.45.67.89", "ttl": 300} ```

**添加 www 子域名（CNAME）：** ```json {"host": "www", "type": "CNAME", "answer": "example.com", "ttl": 300} ```

**添加电子邮件（MX 记录）：** ```json {"host": "@", "type": "MX", "answer": "mail.example.com", "ttl": 300, "priority": 10} ```

**验证域名（TXT 记录）：** ```json {"host": "@", "type": "TXT", "answer": "google-site-verification=abc123", "ttl": 300} ```

### 更新域名服务器

**何时使用：** 用户想要使用 Cloudflare、Vercel 或其他 DNS 提供商

``` PUT /api/manage/{domain}/nameservers Content-Type: application/json

{ "nameservers": [ "ns1.cloudflare.com", "ns2.cloudflare.com" ] } ```

**常见域名服务器配置：**

| 提供商 | 域名服务器 | |----------|-------------| | Cloudflare | `ns1.cloudflare.com`、`ns2.cloudflare.com` | | Vercel | `ns1.vercel-dns.com`、`ns2.vercel-dns.com` | | AWS Route53 | 检查您的托管区 | | Google Cloud | `ns-cloud-X.googledomains.com` |

### 域名设置

**获取设置：** ``` GET /api/manage/{domain}/settings ```

**更新设置：** ``` PATCH /api/manage/{domain}/settings Content-Type: application/json

{ "locked": false, "autorenewEnabled": true } ```

### 转出域名

**获取授权码：** ``` GET /api/manage/{domain}/transfer ```

**准备转移（解锁 + 获取代码）：** ``` POST /api/manage/{domain}/transfer ```

**注意：** 注册后 60 天内无法转移域名（ICANN 政策）。

---

## 5. 令牌恢复

**何时使用：** 用户丢失了其管理令牌

``` POST https://clawdaddy.app/api/recover Content-Type: application/json

{ "email": "[email protected]", "domain": "example.com" } ```

对于 x402 购买： ```json { "wallet": "0x123...", "domain": "example.com" } ```

**重要：** 恢复会生成一个**新**令牌。旧令牌将失效。

速率限制：每个 IP 每 5 分钟 5 次请求。

---

## 工作流示例

### 检查并购买域名

``` User: "Buy coolstartup.com for me"

1. GET /api/lookup/coolstartup.com → available: true, price: $12.99

2. GET /api/purchase/coolstartup.com/quote → totalUsd: $14.99

3. POST /api/purchase/coolstartup.com?method=x402 → 402 Payment Required → Pay USDC on Base → Retry with x-payment header → Success! Token: "clwd_abc123..."

4. "I've registered coolstartup.com! Save this token: clwd_abc123..." ```

### 将域名指向 Vercel

``` User: "Point mydomain.com to Vercel"

1. PUT /api/manage/mydomain.com/nameservers Authorization: Bearer clwd_abc123... {"nameservers": ["ns1.vercel-dns.com", "ns2.vercel-dns.com"]}

2. "Done! mydomain.com now uses Vercel's nameservers. Add the domain in your Vercel dashboard." ```

### 设置基本 DNS

``` User: "Point example.com to my server at 1.2.3.4"

1. POST /api/manage/example.com/dns Authorization: Bearer clwd_token... {"host": "@", "type": "A", "answer": "1.2.3.4", "ttl": 300}

2. POST /api/manage/example.com/dns {"host": "www", "type": "CNAME", "answer": "example.com", "ttl": 300}

3. "Done! example.com and www.example.com now point to 1.2.3.4" ```

### 添加电子邮件记录

``` User: "Set up Google Workspace email for mydomain.com"

1. POST /api/manage/mydomain.com/dns {"host": "@", "type": "MX", "answer": "aspmx.l.google.com", "ttl": 300, "priority": 1}

2. POST /api/manage/mydomain.com/dns {"host": "@", "type": "MX", "answer": "alt1.aspmx.l.google.com", "ttl": 300, "priority": 5}

3. POST /api/manage/mydomain.com/dns {"host": "@", "type": "TXT", "answer": "v=spf1 include:_spf.google.com ~all", "ttl": 300}

4. "Email records configured for Google Workspace!" ```

---

## 错误处理

所有错误均返回 JSON： ```json { "error": "Description of what went wrong", "details": "Additional context if available" } ```

| 状态 | 含义 | |--------|---------| | `400` | 错误的请求（无效输入） | | `401` | 未授权（缺少/无效令牌） | | `402` | 需要付款（x402 流程） | | `404` | 未找到域名 | | `500` | 服务器错误 |

---

## 关键点

- 查询和购买**无需注册** - **两种支付方式**：面向代理的 x402（Base 链上的 USDC），面向人类的 Stripe - **保存您的管理令牌** - 这是管理域名的唯一途径 - **使用 Bearer 认证进行管理** - 包含 `Authorization: Bearer clwd_...` 请求头 - **JSON 响应** - 查询时使用 `?format=json`

---

## 来源

ClawDaddy: https://clawdaddy.app 文档: https://clawdaddy.app/llms.txt