NameOcean API 让任何程序或 AI 助手都能完成您在控制面板中的操作:搜索和注册域名、更改域名服务器、编辑 DNS 记录、签发 SSL 证书、开放端口以及将域名绑定到您的服务器。
打开控制台 → API 密钥,选择该密钥可执行的操作,然后复制密钥。
将下方提示词连同您的密钥一起粘贴到 Claude、ChatGPT 或 Cursor 中。
“将 blog.example.com 指向 203.0.113.10,并开启 SSL。”
您可以通过 NameOcean API 管理我的域名。请阅读 https://nameocean.net/llms.txt 了解其工作方式。我的 API 密钥是:[在此粘贴您的密钥]。凡是涉及费用的操作,请务必先征求我的同意。
为每个工具单独分配一个密钥,并仅授予其所需的权限。如果某个密钥泄露,请在控制台中删除它;其他密钥不受影响。
NameOcean 提供远程 MCP 服务器。只需添加一次,您的 AI 就可以管理 DNS、SSL、服务器、端口和域名绑定。您在浏览器中登录即可,无需粘贴 API 密钥,也无需安装任何软件。
$ 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。
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
当域名注册成功或即将到期、DNS 记录变更或证书签发时,接收一条已签名的 POST 请求,无需轮询 API。
使用您自己的域名发送事务性邮件并获取投递事件,创建邮箱、别名和邮件列表,为在此注册的域名开启免费转发,并以 JSON 格式在您的端点接收来信。
请在每个请求的 Authorization 标头中发送您的密钥。响应均为 JSON 格式。限制为每分钟 120 个请求。
$ 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:read | Webhook 端点及其投递记录 |
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 | 转移码 |
| 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 即代码 → |
| 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}/deploys | git push 之后:重启应用并记录部署 |
| GET | /servers/{server}/logs | 应用日志 · 所有服务器端点 → |
# 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/ 同样会返回自身的说明。