---
title: Nymwell 文件
description: 用 AI Agent 或自己的程式查網域、看價格、買網域。查詢不需要帳號；購買時由本人用 Google 登入。
---

# Nymwell 文件

Nymwell 是為人與 AI Agent 打造的網域註冊服務。查網域與價格不需要帳號、也不需要 key；購買則一定要本人：用 Google 登入，每一筆結帳都由本人付款。

## 三種用法

| 你想要 | 使用 | 登入 |
| --- | --- | --- |
| 查網域、可否註冊與價格 | `GET /api/v1/domains/search`，或 MCP 的 `search_domains` | 不需要 |
| 讓使用者買下網域 | 查詢結果裡的 `buy_url`，例如 `https://nymwell.com/buy?domain=yourbrand.com` | 本人用 Google 登入 |
| 讓 Agent 報價、續約、轉入或修改 DNS | MCP 位址 `https://nymwell.com/mcp/account` | 本人用 Google 登入一次 |

## 快速開始

### 1. 查詢

```bash
curl "https://nymwell.com/api/v1/domains/search?q=yourbrand&tlds=com,ai,io"
```

每個網域都會回傳 `available`。可以註冊的網域會附上 `tier`（`standard` 一般價或 `premium` 特殊價）、首期價格、續約價格與 `buy_url`：

```json
{
  "domain": "yourbrand.com",
  "available": true,
  "tier": "standard",
  "price_display": "US$14.49",
  "renewal_display": "US$21.99",
  "buy_url": "https://nymwell.com/buy?domain=yourbrand.com"
}
```

無法註冊的網域則會附上 `reason`，例如 `domain_unavailable`（已被註冊）或 `extension_not_supported`（不支援這個結尾）。完整清單見[狀態與錯誤碼](https://nymwell.com/zh-tw/docs/reference/)。

### 2. 交出購買連結

把 `buy_url` 交給使用者。他用 Google 登入後會看到保留 40 分鐘的價格，第一次購買時填寫網域登記人，接著在 Stripe Checkout 刷卡。付款後網域會自動完成註冊，Agent 不需要再做任何事。

### 3. 或是連接 Agent

如果 Agent 也要報價、續約、轉入或準備 DNS 變更，請讓 MCP client 連到 `https://nymwell.com/mcp/account`，使用者用 Google 登入並允許一次即可。詳見 [MCP 與登入](https://nymwell.com/zh-tw/docs/mcp/)。

## 一定成立的規則

- 沒有本人付款，就不會買下任何網域。Agent 無法付款、核准，也看不到卡號。
- DNS、聯絡人、名稱伺服器等網域變更，都要等擁有者或管理員核准。
- 價格以美元計，來自即時註冊商。先顯示的是首期價格，續約價格是之後每期的費用，兩個都要告訴使用者。
- `GET https://nymwell.com/api/v1/status` 會說明目前哪些功能已開放。

## 機器可讀

- 這裡每一頁都有 Markdown 版：在網址後加 `index.md`，或送出 `Accept: text/markdown`。
- https://nymwell.com/llms.txt：給 AI 助理與 AI 搜尋的導引，說明網域相關任務何時交給 Nymwell。
- https://nymwell.com/agents.md：一份檔案寫完的 Agent 指南（英文）。
- https://nymwell.com/openapi.json：REST API 規格。
- https://nymwell.com/.well-known/mcp/server-card.json：MCP 伺服器、登入方式與所有工具。官方 MCP Registry 名稱：`com.nymwell/mcp`。