Gerenciamento de DNS da Namecheap

HABILIDADE UTILITÁRIA — gerencia registros DNS através da API da Namecheap. USE PARA: "adicionar registro DNS", "atualizar registro A", "gerenciar domínios Namecheap", "definir CNAME", "adicionar registro MX", "adicionar registro TXT", "listar meus domínios", "mostrar registros DNS", "configuração Namecheap", "configurar API Namecheap", "qual é meu IP público" NÃO USE PARA: registro/compra de domínio, gerenciamento de certificado SSL, configuração de hospedagem, provedores de DNS não Namecheap

Fluxo de Trabalho

Configuração Inicial

Antes de executar quaisquer comandos da API, verifique se as credenciais estão configuradas:

1. Verificar configuração existente — procure por ~/.namecheap-api
2. Se não estiver configurado, guie o usuário através da configuração: a. Mostrar IP público — execute python3 namecheap.py public-ip para exibir o IP público do usuário b. Instruir sobre lista de permissões de IP — diga ao usuário para ir para https://ap.www.namecheap.com/settings/tools/apiaccess/, ativar a API (selecionar LIGADO) e adicionar o IP exibido à lista de permissões. c. Peça ao usuário para executar a configuração ele mesmo — peça ao usuário para executar python3 namecheap.py setup diretamente em seu próprio terminal. O script solicita o nome de usuário e lê a chave da API com um prompt oculto (getpass), grava ~/.namecheap-api com chmod 600 e valida a conexão. Nunca peça ao usuário para colar sua chave de API no chat, e nunca registre, exiba ou mostre o valor da chave de API. Se você não puder executar um terminal interativo para o usuário, instrua-o a executar setup ele mesmo, ou a exportar NAMECHEAP_API_USER e NAMECHEAP_API_KEY como variáveis de ambiente em seu próprio shell — em vez de coletar o segredo via ask_user. d. Confirmar — assim que o usuário relatar que a configuração foi bem-sucedida, prossiga com as operações de DNS.

Operações de DNS

Use o script namecheap.py (incluído no diretório desta habilidade) para todas as interações com a API. Ele requer apenas Python 3 (apenas biblioteca padrão — sem pip install necessário) e funciona da mesma forma em macOS, Linux e Windows:

# Show public IP (for setup)
python3 namecheap.py public-ip

# Run setup flow
python3 namecheap.py setup

# List domains
python3 namecheap.py domains.getList

# Get nameservers for a domain (shows if using Namecheap DNS or custom)
python3 namecheap.py domains.dns.getList --domain example.com

# Get DNS records for a domain
python3 namecheap.py domains.dns.getHosts --domain example.com

# Add a single record (preserves existing records)
python3 namecheap.py dns.addHost --domain example.com --type A --name www --address 1.2.3.4 --ttl 1800

# Remove a single record
python3 namecheap.py dns.removeHost --domain example.com --type A --name www --address 1.2.3.4

# Replace all records from a JSON file
python3 namecheap.py domains.dns.setHosts --domain example.com --hosts records.json

# Switch to Namecheap default DNS
python3 namecheap.py domains.dns.setDefault --domain example.com

# Switch to custom nameservers
python3 namecheap.py domains.dns.setCustom --domain example.com --nameservers ns1.cloudflare.com,ns2.cloudflare.com

# Get email forwarding rules
python3 namecheap.py domains.dns.getEmailForwarding --domain example.com

# Set email forwarding (single rule)
python3 namecheap.py domains.dns.setEmailForwarding --domain example.com --mailbox info --forward-to user@gmail.com

# Set email forwarding (from JSON file)
python3 namecheap.py domains.dns.setEmailForwarding --domain example.com --forwards forwards.json

# Create a child nameserver (glue record)
python3 namecheap.py domains.ns.create --domain example.com --nameserver ns1.example.com --ip 1.2.3.4

# Delete a child nameserver
python3 namecheap.py domains.ns.delete --domain example.com --nameserver ns1.example.com

# Get nameserver info
python3 namecheap.py domains.ns.getInfo --domain example.com --nameserver ns1.example.com

# Update nameserver IP
python3 namecheap.py domains.ns.update --domain example.com --nameserver ns1.example.com --old-ip 1.2.3.4 --ip 5.6.7.8

Formatos de arquivo JSON

domains.dns.setHosts --hosts records.json espera um array de objetos com os nomes dos campos da API da Namecheap:

[
  { "HostName": "@", "RecordType": "A", "Address": "1.2.3.4", "TTL": 1800 },
  { "HostName": "www", "RecordType": "CNAME", "Address": "@", "TTL": 1800 },
  { "HostName": "@", "RecordType": "MX", "Address": "mail.example.com.", "TTL": 1800, "MXPref": 10 }
]

domains.dns.setEmailForwarding --forwards forwards.json espera um array de regras de caixa de correio:

[
  { "MailBox": "info", "ForwardTo": "team@example.net" },

…