Nymwell 文件
Nymwell 是為人與 AI Agent 打造的網域註冊服務。查網域與價格不需要帳號、也不需要 key;購買則一定要本人:用 Google 登入,每一筆結帳都由本人付款。
三種用法
| 你想要 | 使用 | 登入 |
|---|---|---|
| 查網域、可否註冊與價格 | GET /api/v1/domains/search,或 MCP 的 search_ | 不需要 |
| 讓使用者買下網域 | 查詢結果裡的 buy_,例如 https://nymwell.com/buy?domain=yourbrand.com | 本人用 Google 登入 |
| 讓 Agent 報價、續約、轉入或修改 DNS | MCP 位址 https://nymwell.com/mcp/account | 本人用 Google 登入一次 |
快速開始
1. 查詢
curl "https://nymwell.com/api/v1/domains/search?q=yourbrand&tlds=com,ai,io"
每個網域都會回傳 available。可以註冊的網域會附上 tier(standard 一般價或 premium 特殊價)、首期價格、續約價格與 buy_url:
{
"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(不支援這個結尾)。完整清單見狀態與錯誤碼。
2. 交出購買連結
把 buy_url 交給使用者。他用 Google 登入後會看到保留 40 分鐘的價格,第一次購買時填寫網域登記人,接著在 Stripe Checkout 刷卡。付款後網域會自動完成註冊,Agent 不需要再做任何事。
3. 或是連接 Agent
如果 Agent 也要報價、續約、轉入或準備 DNS 變更,請讓 MCP client 連到 https://nymwell.com/mcp/account,使用者用 Google 登入並允許一次即可。詳見 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。