A API da NameOcean permite que qualquer programa, ou qualquer assistente de IA, faça o que você faz no painel: pesquisar e registar domínios, alterar nameservers, editar registos DNS, emitir certificados SSL, abrir portas e associar domínios aos seus servidores.
Abra Painel → Chaves de API, escolha o que a chave pode fazer e copie-a.
Cole o prompt abaixo no Claude, no ChatGPT ou no Cursor, juntamente com a sua chave.
"Aponte blog.example.com para 203.0.113.10 e ative o SSL."
Pode gerir os meus domínios com a API da NameOcean. Leia https://nameocean.net/llms.txt para saber como funciona. A minha chave de API é: [cole aqui a sua chave]. Pergunte-me sempre antes de qualquer ação que implique custos.
Dê a cada ferramenta a sua própria chave, apenas com as permissões de que ela precisa. Se uma chave vazar, exclua-a no painel; as outras continuam funcionando.
A NameOcean disponibiliza um servidor MCP remoto. Adicione-o uma vez e a sua IA poderá gerir DNS, SSL, servidores, portas e associações de domínios. Inicia sessão no navegador; sem chave de API para colar e nada para instalar.
$ claude mcp add --transport http nameocean https://nameocean.net/mcp
Claude Desktop e claude.ai: Definições → Conectores → Adicionar conector personalizado, URL https://nameocean.net/mcp.
Cursor, VS Code, OpenCode e outros: adicione um servidor MCP HTTP com o mesmo URL.
Os clientes sem OAuth podem enviar Authorization: Bearer <API key>.
As chaves de API e as ligações de aplicações exigem início de sessão em dois passos na sua conta. Ativar
O servidor MCP não pode registar nem renovar domínios nem adicionar crédito, e só cria um servidor pago depois de aceitar o preço. Pode desligar aplicações a qualquer momento em Painel → Aplicações ligadas.
A CLI nameocean faz o mesmo a partir do seu terminal e dos seus scripts, e o comando nameocean mcp install conecta o Claude Code, o Cursor, o OpenCode e o VS Code para você.
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
Receba um POST assinado quando um domínio for registrado ou estiver prestes a expirar, um registro DNS mudar ou um certificado for emitido, em vez de consultar a API repetidamente.
Envie e-mails transacionais a partir do seu próprio domínio com eventos de entrega, crie caixas de correio, aliases e listas de distribuição, ative o reencaminhamento gratuito para domínios registados aqui e receba o correio recebido no seu endpoint em JSON.
Envie a sua chave no cabeçalho Authorization de cada pedido. As respostas são em JSON. O limite é de 120 pedidos por minuto.
$ 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}
Crie quantas chaves precisar em Painel → Chaves de API, cada uma apenas com as permissões de que sua ferramenta precisa, uma data de expiração opcional e uma lista opcional de IPs permitidos. A chave é exibida uma única vez; a NameOcean guarda apenas sua impressão digital.
Uma chave também pode ser limitada a alguns dos seus domínios. Nesse caso, funciona apenas nos endpoints desses domínios (DNS, SSL, definições do domínio, o respetivo email e reencaminhamento), vê apenas esses domínios em GET /dns e recebe 403 domain_not_allowed em qualquer outro lugar, incluindo servidores, faturação e os seus outros domínios. Utilize uma para tarefas de CI e ferramentas como certbot, octoDNS ou DNSControl.
account:read | E-mail e crédito da conta |
domains:read | Listar domínios, verificar disponibilidade e preço |
domains:write | Alterar renovação automática, bloqueio e nameservers; ler o código de transferência |
dns:read | Listar zonas e registros DNS |
dns:write | Criar zonas; adicionar, alterar e excluir registros |
ssl:read | Status do certificado |
ssl:write | Emitir certificados, alterar renovação automática |
servers:read | Servidores de aplicação, suas portas e domínios |
servers:write | Abrir e fechar portas, vincular e desvincular domínios |
email:read | Domínios de e-mail, caixas de correio, aliases, reencaminhamento e o respetivo registo |
email:write | Adicione e elimine caixas de correio, aliases e listas; defina palavras-passe; ative e desative o reencaminhamento |
email:send | Enviar e-mails a partir das suas caixas de correio (POST /email/send) |
monitors:read | Monitores de disponibilidade, o seu estado e incidentes |
monitors:write | Adicionar, alterar, pausar e eliminar monitores de disponibilidade |
webhooks:read | Endpoints de webhook e suas entregas |
webhooks:write | Adicione, altere e exclua endpoints de webhook, envie testes e reenvie entregas |
billing:write | Registrar e renovar domínios (usa o crédito da conta) |
GET exige <area>:read; os demais métodos, <area>:write. Registrar e renovar um domínio também exigem billing:write; vincular um domínio a um servidor também exige dns:write. Uma chamada sem o escopo responde 403 com required_scopes. As mesmas regras se aplicam ao servidor MCP quando ele é usado com uma chave.
URL base: https://nameocean.net/api/v1/
A referência da API traz todos os campos, códigos de erro e um exemplo curl por endpoint; o openapi.json pode ser importado no Postman ou no Insomnia.
| GET | /domains/check?name=example.com | Disponibilidade e preço |
| GET | /whois/{name} | Dados WHOIS/RDAP de qualquer domínio: registrador, datas, status, servidores de nomes |
| GET | /domains | Listar os seus domínios |
| POST | /domains | Registar um domínio, pago a partir do seu saldo {"name", "years"} |
| GET | /domains/{name} | Detalhes, nameservers, estado do SSL |
| PATCH | /domains/{name} | Renovação automática e bloqueio de transferência {"auto_renew", "locked"} |
| PUT | /domains/{name}/nameservers | {"nameservers": [...]} ou "nameocean" |
| POST | /domains/{name}/renew | Renovar por um ano (nos 60 dias anteriores à expiração) |
| GET | /domains/{name}/auth-code | Código de transferência |
| GET | /dns | Listar zonas DNS |
| POST | /dns | Criar uma zona para um domínio registado noutro local {"name"} |
| GET | /dns/{zone}/records | Listar registos |
| POST | /dns/{zone}/records | Adicionar um registo: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT |
| PATCH | /dns/{zone}/records/{type}/{id} | Alterar um registo |
| DELETE | /dns/{zone}/records/{type}/{id} | Eliminar um registo |
| POST | /dns/{zone}/plan · apply | Altere a zona inteira a partir de um arquivo YAML ou JSON · DNS como código → |
| GET | /ssl/{zone} | Estado, data de expiração e link de download |
| POST | /ssl/{zone} | Emitir um certificado wildcard gratuito |
| PATCH | /ssl/{zone} | Renovação automática {"auto_renew"} |
{server} é o ID do servidor ou o seu domínio padrão, como 3f9a1c2e.nameocean.org.
| GET | /servers | Os seus servidores com SSH, git remote, portas e domínios |
| GET | /servers/{server} | Um servidor |
| GET | /servers/{server}/ports | Portas abertas |
| POST | /servers/{server}/ports | Abrir uma porta TCP ou UDP {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Fechar uma porta |
| GET | /servers/{server}/domains | Domínios associados e o seu estado |
| POST | /servers/{server}/domains | Associar um domínio ou subdomínio com HTTPS {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Desassociar um domínio |
| POST | /servers/{server}/deploys | Após o git push: reinicie as aplicações e registe o deploy |
| GET | /servers/{server}/logs | Logs das aplicações · todos os endpoints do servidor → |
# 1. Consultar o preço curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY" # 2. Registar (debita do seu saldo) 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. Apontar para o seu servidor 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 wildcard gratuito curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"
A referência completa para agentes de IA, com todos os campos e tipos de registo, está em nameocean.net/llms.txt. GET /api/v1/ também se descreve a si mesmo.