黑色星期五: 充值即得双倍余额,最多免费赠送 $50($25 → $50,$50 → $100)。可用于一切:域名、主机、邮箱。 优惠码:BLACKFRIDAY2026 获取双倍余额 →

给您的 AI 一个密钥,它来帮您管理域名。

NameOcean API 让任何程序或 AI 助手都能完成您在控制面板中的操作:搜索和注册域名、更改域名服务器、编辑 DNS 记录、签发 SSL 证书、开放端口以及将域名绑定到您的服务器。

  1. 1

    创建密钥

    打开控制台 → API 密钥,选择该密钥可执行的操作,然后复制密钥。

  2. 2

    提供给您的 AI

    将下方提示词连同您的密钥一起粘贴到 Claude、ChatGPT 或 Cursor 中。

  3. 3

    用日常语言提问

    “将 blog.example.com 指向 203.0.113.10,并开启 SSL。”

给您的 AI 助手的提示词

您可以通过 NameOcean API 管理我的域名。请阅读 https://nameocean.net/llms.txt 了解其工作方式。我的 API 密钥是:[在此粘贴您的密钥]。凡是涉及费用的操作,请务必先征求我的同意。

为每个工具单独分配一个密钥,并仅授予其所需的权限。如果某个密钥泄露,请在控制台中删除它;其他密钥不受影响。

连接 Claude Code、Cursor 或任何 MCP 客户端

NameOcean 提供远程 MCP 服务器。只需添加一次,您的 AI 就可以管理 DNS、SSL、服务器、端口和域名绑定。您在浏览器中登录即可,无需粘贴 API 密钥,也无需安装任何软件。

Claude Code
$ claude mcp add --transport http nameocean https://nameocean.net/mcp

Claude Desktop 和 claude.ai:设置 → 连接器 → 添加自定义连接器,URL 为 https://nameocean.net/mcp. Cursor、VS Code、OpenCode 等:使用相同的 URL 添加 HTTP MCP 服务器。 不支持 OAuth 的客户端可以发送 Authorization: Bearer <API key>.

API 密钥和应用连接需要您的账户启用两步验证登录。 立即开启

MCP 服务器无法注册或续费域名,也无法充值;只有在您同意价格后,才会创建付费服务器。您可以随时断开应用的连接,位置: 控制台 → 已连接的应用.

各客户端的设置方法及全部工具 →

命令行

nameocean CLI 可在终端和脚本中实现相同的操作,nameocean mcp install 会自动为您连接 Claude Code、Cursor、OpenCode 和 VS Code。

nameocean
$ curl -fsSL https://nameocean.net/install.sh | sh
$ nameocean login
$ nameocean dns add example.com A @ 203.0.113.10

安装选项和全部命令 →

Webhooks

当域名注册成功或即将到期、DNS 记录变更或证书签发时,接收一条已签名的 POST 请求,无需轮询 API。

事件、负载与签名验证 →

电子邮件

使用您自己的域名发送事务性邮件并获取投递事件,创建邮箱、别名和邮件列表,为在此注册的域名开启免费转发,并以 JSON 格式在您的端点接收来信。

Email API 指南 →

身份验证

请在每个请求的 Authorization 标头中发送您的密钥。响应均为 JSON 格式。限制为每分钟 120 个请求。

curl
$ curl https://nameocean.net/api/v1/account \
    -H "Authorization: Bearer $NAMEOCEAN_API_KEY"

{"email": "you@example.com", "credit": "42.00", "currency": "USD", "domains": 3, "dns_zones": 3}

密钥权限(作用域)

您可以在 控制面板 → API 密钥 中按需创建任意数量的密钥,每个密钥仅授予对应工具所需的权限,并可选设置过期日期和允许的 IP 列表。密钥仅显示一次;NameOcean 只保存其指纹。

密钥也可以限定为仅用于您的部分域名。此时它只能调用这些域名的接口(DNS、SSL、域名设置、邮箱和转发),在 GET /dns 中也只能看到这些域名,访问其他任何内容(包括服务器、账单和您的其他域名)都会返回 403 domain_not_allowed。适用于 CI 任务以及 certbot、octoDNS 或 DNSControl 等工具。

account:read邮箱和账户余额
domains:read列出域名,查询可用性和价格
domains:write更改自动续费、锁定状态和域名服务器;读取转移码
dns:read列出 DNS 区域和记录
dns:write创建区域;添加、更改和删除记录
ssl:read证书状态
ssl:write签发证书,更改自动续费
servers:read应用服务器及其端口和域名
servers:write开放和关闭端口,绑定和解绑域名
email:read邮件域名、邮箱、别名、转发及其日志
email:write添加和删除邮箱、别名和邮件列表;设置密码;开启和关闭转发
email:send从您的邮箱发送邮件(POST /email/send)
monitors:read在线监控项及其状态和事件
monitors:write添加、修改、暂停和删除在线监控项
webhooks:readWebhook 端点及其投递记录
webhooks:write添加、修改和删除 Webhook 端点,发送测试,重新投递
billing:write注册和续费域名(会扣除账户余额)

GET 请求需要 <area>:read,其他方法需要 <area>:write。注册和续费域名还需要 billing:write;将域名绑定到服务器还需要 dns:write。缺少所需作用域的调用将返回 403 及 required_scopes。通过密钥使用 MCP 服务器时,同样适用这些规则。

端点

基础 URL: https://nameocean.net/api/v1/

API 参考文档列出了所有字段、错误代码,并为每个端点提供 curl 示例;openapi.json 可导入 Postman 或 Insomnia。

域名

GET/domains/check?name=example.com可用性和价格
GET/whois/{name}任意域名的 WHOIS/RDAP 数据:注册商、日期、状态、域名服务器
GET/domains列出您的域名
POST/domains注册域名,从您的余额中扣款 {"name", "years"}
GET/domains/{name}详情、域名服务器、SSL 状态
PATCH/domains/{name}自动续费和转移锁 {"auto_renew", "locked"}
PUT/domains/{name}/nameservers{"nameservers": [...]} 或 "nameocean"
POST/domains/{name}/renew续费一年(到期前 60 天内)
GET/domains/{name}/auth-code转移码

DNS

GET/dns列出 DNS 区域
POST/dns为在其他注册商注册的域名创建区域 {"name"}
GET/dns/{zone}/records列出记录
POST/dns/{zone}/records添加记录: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT
PATCH/dns/{zone}/records/{type}/{id}修改记录
DELETE/dns/{zone}/records/{type}/{id}删除记录
POST/dns/{zone}/plan · apply通过 YAML 或 JSON 文件修改整个区域 · DNS 即代码 →

SSL

GET/ssl/{zone}状态、到期日期和下载链接
POST/ssl/{zone}签发免费通配符证书
PATCH/ssl/{zone}自动续费 {"auto_renew"}

应用服务器

{server} 是服务器 ID 或其默认域名,例如 3f9a1c2e.nameocean.org。

GET/servers您的服务器,包含 SSH、git remote、端口和域名
GET/servers/{server}单个服务器
GET/servers/{server}/ports开放端口
POST/servers/{server}/ports开放 TCP 或 UDP 端口 {"port", "protocol"}
DELETE/servers/{server}/ports/{id}关闭端口
GET/servers/{server}/domains已绑定的域名及其状态
POST/servers/{server}/domains绑定域名或子域名并启用 HTTPS {"domain"}
DELETE/servers/{server}/domains/{id}解绑域名
POST/servers/{server}/deploysgit push 之后:重启应用并记录部署
GET/servers/{server}/logs应用日志 · 所有服务器端点 →

示例:为新域名启用 HTTPS

bash
# 1. 查询价格
curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY"

# 2. 注册(从您的余额中扣费)
curl -X POST https://nameocean.net/api/v1/domains -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"name": "kahvebot.com", "years": 1}'

# 3. 指向您的服务器
curl -X POST https://nameocean.net/api/v1/dns/kahvebot.com/records -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"type": "A", "hostname": "@", "ip": "203.0.113.10", "ttl": "5m"}'

# 4. 免费通配符 SSL
curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"

面向 AI 代理的完整参考文档(包含所有字段和记录类型)位于 nameocean.net/llms.txt。GET /api/v1/ 同样会返回自身的说明。