NovidadeO Cheep 0.1.0 já está disponível. Instala-o com o Homebrew, com o Go ou com um binário pré-compilado.
Código aberto · CLI não oficial da Namecheap
Namecheap direto do terminal.
Verifica domínios, consulta os preços da tua conta e altera o DNS com planos revistos, a partir do terminal ou do teu agente de IA.
Instalar com o Homebrew
brew install turushan/tap/cheep macOS, Linux e Windows · Grátis sob a licença MIT · Outras formas de instalar
Experimenta o painel
Todos os nomes num só comando.
Escreve um nome e o painel alinha os domínios a verificar. O Cheep pede as respostas em tempo real à Namecheap, no teu próprio computador e com a tua própria chave de API.
Esta página não faz nenhuma consulta. O Cheep mostra as respostas no teu terminal.
Executa este comando para os verificar
cheep domains check paperkite.com paperkite.dev paperkite.app paperkite.io paperkite.co paperkite.sh $ cheep domains check paperkite.dev paperkite.com paperkite.app paperkite.co DOMAIN AVAILABLE PREMIUM PREMIUM REGISTRATION paperkite.dev yes no 0.00 paperkite.com no no 0.00 paperkite.app yes no 0.00 paperkite.co yes yes 1288.00
$ cheep --json domains check paperkite.dev paperkite.com {"schema_version":"v1","command":"domains.check","ok":true,"data":[{"domain":"paperkite.dev","available":true,"premium":false,"premium_registration_price":0},{"domain":"paperkite.com","available":false,"premium":false,"premium_registration_price":0}],"meta":{"profile":"live","environment":"production"}}
Saída de exemplo da CLI real. O Cheep pede sempre a resposta em tempo real à Namecheap.
Gastar dinheiro
Dinheiro de verdade exige um sim de verdade.
Em produção, qualquer chamada que possa gerar uma cobrança na tua conta fica parada até adicionares três flags. O Cheep diz-te de cada vez qual falta, por isso um deslize custa uma nova tentativa, e não dinheiro.
--yesAprova a alteração. Executa primeiro --dry-run para veres os parâmetros que o Cheep enviaria.--productionConfirma que a alteração é para a tua conta real, e não para a sandbox.--accept-chargeConfirma que verificaste o preço atual antes de o Cheep gastar alguma coisa.
- Primeiro, a sandbox Os perfis novos começam na sandbox da Namecheap, por isso nada de real muda enquanto aprendes.
- Simulações Adiciona --dry-run a qualquer alteração de DNS ou da API. O Cheep mostra o que faria e não altera nada.
- Chaves no teu porta-chaves O Cheep guarda a tua chave de API no gestor de credenciais do sistema operativo, nunca no ficheiro de configuração.
DNS
Altera o DNS com um plano revisto.
A Namecheap reescreve a zona inteira de uma só vez, por isso o Cheep trata cada alteração como uma alteração à zona toda. Exportas a zona, editas o ficheiro e lês o plano antes de o aplicares.
- ExportaA zona completa, num ficheiro YAML versionado.
- PlaneiaCada adição e remoção, antes de qualquer alteração.
- AplicaPrimeiro um snapshot, depois uma única escrita e uma releitura de confirmação.
- RestauraVolta a um snapshot com um só comando.
Ao aplicar, o Cheep volta a ler a zona atual mesmo antes de escrever e interrompe tudo se ela tiver mudado entretanto. Ler o guia de DNS (inglês)
Agentes de IA
Feito para agentes de IA.
O teu agente executa os mesmos comandos que tu, com um envelope JSON estável. Os dados vão para o stdout, os erros para o stderr, e os códigos de saída estão documentados.
Códigos de saída
0 | Sucesso |
|---|---|
1 | Erro inesperado |
2 | Erro de utilização |
3 | Credenciais em falta ou inválidas |
4 | Erro de rede ou tempo esgotado |
5 | A Namecheap devolveu um erro |
6 | Conflito ou resultado desconhecido |
7 | Recusado por um bloqueio de segurança |
8 | Uma cobrança precisa de --accept-charge |
130 | Interrompido |
--jsonUm envelope versionado com o comando, o resultado e o perfil usado.--no-inputNunca fica à espera de uma resposta, por isso uma execução sem supervisão nunca fica bloqueada.--readonlyRecusa qualquer alteração à tua conta da Namecheap, com o código de saída 7.
Uma linha para as instruções do teu agente
cheep --json --no-input --readonly domains check paperkite.dev API completa
Os 59 métodos da API da Namecheap.
Comandos dedicados tratam do trabalho do dia a dia. Para tudo o resto, o cheep api chega a todos os métodos do catálogo oficial da Namecheap, e cada escrita ou cobrança espera pelas suas flags.
59 de 59
| Comando | Método da Namecheap | Modo |
|---|---|---|
cheep api domainprivacy change-email-address | namecheap.whoisguard.changeemailaddress | escrita |
cheep api domainprivacy disable | namecheap.whoisguard.disable | escrita |
cheep api domainprivacy enable | namecheap.whoisguard.enable | escrita |
cheep api domainprivacy get-list | namecheap.whoisguard.getlist | leitura |
cheep api domainprivacy renew | namecheap.whoisguard.renew | cobrança |
cheep api domains check | namecheap.domains.check | leitura |
cheep api domains create | namecheap.domains.create | cobrança |
cheep api domains dns get-email-forwarding | namecheap.domains.dns.getEmailForwarding | leitura |
cheep api domains dns get-hosts | namecheap.domains.dns.getHosts | leitura |
cheep api domains dns get-list | namecheap.domains.dns.getList | leitura |
cheep api domains dns set-custom | namecheap.domains.dns.setCustom | escrita |
cheep api domains dns set-default | namecheap.domains.dns.setDefault | escrita |
cheep api domains dns set-email-forwarding | namecheap.domains.dns.setEmailForwarding | escrita |
cheep api domains dns set-hosts | namecheap.domains.dns.setHosts | escrita |
cheep api domains get-contacts | namecheap.domains.getContacts | leitura |
cheep api domains get-info | namecheap.domains.getInfo | leitura |
cheep api domains get-list | namecheap.domains.getList | leitura |
cheep api domains get-registrar-lock | namecheap.domains.getRegistrarLock | leitura |
cheep api domains get-tld-list | namecheap.domains.getTldList | leitura |
cheep api domains ns create | namecheap.domains.ns.create | escrita |
cheep api domains ns delete | namecheap.domains.ns.delete | escrita |
cheep api domains ns get-info | namecheap.domains.ns.getInfo | leitura |
cheep api domains ns update | namecheap.domains.ns.update | escrita |
cheep api domains reactivate | namecheap.domains.reactivate | cobrança |
cheep api domains renew | namecheap.domains.renew | cobrança |
cheep api domains set-contacts | namecheap.domains.setContacts | escrita |
cheep api domains set-registrar-lock | namecheap.domains.setRegistrarLock | escrita |
cheep api domains transfer create | namecheap.domains.transfer.create | cobrança |
cheep api domains transfer get-list | namecheap.domains.transfer.getList | leitura |
cheep api domains transfer get-status | namecheap.domains.transfer.getStatus | leitura |
cheep api domains transfer update-status | namecheap.domains.transfer.updateStatus | escrita |
cheep api ssl activate | namecheap.ssl.activate | escrita |
cheep api ssl create | namecheap.ssl.create | cobrança |
cheep api ssl edit-dcv-method | namecheap.ssl.editDCVMethod | escrita |
cheep api ssl get-approver-email-list | namecheap.ssl.getApproverEmailList | leitura |
cheep api ssl get-info | namecheap.ssl.getInfo | leitura |
cheep api ssl get-list | namecheap.ssl.getList | leitura |
cheep api ssl parse-csr | namecheap.ssl.parseCSR | leitura |
cheep api ssl purchase-more-sans | namecheap.ssl.purchasemoresans | cobrança |
cheep api ssl reissue | namecheap.ssl.reissue | escrita |
cheep api ssl renew | namecheap.ssl.renew | cobrança |
cheep api ssl resend-approver-email | namecheap.ssl.resendApproverEmail | escrita |
cheep api ssl resend-fulfillment-email | namecheap.ssl.resendfulfillmentemail | escrita |
cheep api ssl revoke-certificate | namecheap.ssl.revokecertificate | escrita |
cheep api users address create | namecheap.users.address.create | escrita |
cheep api users address delete | namecheap.users.address.delete | escrita |
cheep api users address get-info | namecheap.users.address.getInfo | leitura |
cheep api users address get-list | namecheap.users.address.getList | leitura |
cheep api users address set-default | namecheap.users.address.setDefault | escrita |
cheep api users address update | namecheap.users.address.update | escrita |
cheep api users change-password | namecheap.users.changePassword | escrita |
cheep api users create | namecheap.users.create | escrita |
cheep api users create-add-funds-request | namecheap.users.createaddfundsrequest | cobrança |
cheep api users get-add-funds-status | namecheap.users.getAddFundsStatus | leitura |
cheep api users get-balances | namecheap.users.getBalances | leitura |
cheep api users get-pricing | namecheap.users.getPricing | leitura |
cheep api users login | namecheap.users.login | leitura |
cheep api users reset-password | namecheap.users.resetPassword | escrita |
cheep api users update | namecheap.users.update | escrita |
Nenhum método corresponde à pesquisa.
Privacidade
Entre ti e a Namecheap.
O Cheep corre no teu computador e só comunica com a API da Namecheap. Nada passa por um servidor nosso, e nunca vemos a tua chave nem os teus domínios.
- Sem telemetria, sem ferramentas de análise e sem verificação de atualizações.
- A tua chave de API fica no gestor de credenciais do sistema operativo.
- Código aberto sob a licença MIT, por isso podes ler cada pedido que faz.
Instalação
A tua primeira verificação em três passos.
- Instala o Cheep
Com o Homebrew no macOS ou no Linux, com Go 1.26.10 ou posterior, ou como binário pré-compilado para macOS, Linux ou Windows.
brew install turushan/tap/cheepOu com Go 1.26.10 ou posterior
Descarregar um binário pré-compiladogo install github.com/turushan/cheep/cmd/cheep@latest - Liga-te à sandbox
Cria na sandbox da Namecheap um utilizador de API, uma chave e um IPv4 público na lista de permissões. Guarda o perfil, armazena a chave e deixa o doctor verificar tudo.
cheep --environment sandbox auth configure sandbox --api-user YOUR_SANDBOX_USER --client-ip YOUR_PUBLIC_IPV4 --defaultcheep auth set-keycheep doctor - Verifica os teus nomes
Consulta quantos nomes quiseres num só comando.
cheep domains check paperkite.dev paperkite.com
A Namecheap exige um utilizador de API, uma chave de API e um IPv4 público na lista de permissões antes de qualquer comando funcionar. Ler o guia de autenticação (inglês)
Perguntas
O Cheep é uma ferramenta oficial da Namecheap?
Não. O Cheep é independente e de código aberto. A Namecheap não o desenvolve, não o apoia oficialmente nem lhe presta suporte. Usa a API pública da Namecheap com a tua própria chave de API.
De que preciso para começar?
Do próprio Cheep, através do Homebrew, do Go ou de um binário pré-compilado, e de uma conta da Namecheap com acesso à API: um utilizador de API, uma chave de API e um endereço IPv4 público na lista de permissões. Experimenta tudo primeiro na sandbox da Namecheap.
Onde fica a minha chave de API?
No gestor de credenciais do teu sistema operativo: o Porta-chaves no macOS, o Gestor de Credenciais no Windows e o Secret Service no Linux. Em servidores, o Cheep lê CHEEP_API_KEY em vez disso. Nunca ponhas a chave num argumento de comando.
O Cheep envia os meus dados para mais algum sítio?
Não. O Cheep só comunica com a API da Namecheap. Não tem telemetria, verificação de atualizações nem servidores nossos.
Consegue registar, renovar e transferir domínios?
Sim, através do cheep api, que chega aos 59 métodos do catálogo da Namecheap. Uma chamada que possa gerar uma cobrança na tua conta precisa de --yes e --accept-charge, e ainda de --production na tua conta real.
O meu agente de IA pode usar o Cheep em segurança?
Sim. Passa-lhe --json para receber um envelope versionado, --no-input para nunca ficar à espera de uma resposta e --readonly quando não puder alterar a tua conta. Uma alteração recusada termina com o código 7.
Porque é que o Cheep começa na sandbox?
Para que nada de real mude enquanto aprendes. Quando chegar a altura, passas um perfil para produção, e as alterações em produção continuam a precisar de --production.
Em que sistemas funciona?
macOS, Linux e Windows, em processadores Intel e ARM. O Homebrew instala-o no macOS e no Linux, e cada versão inclui binários para os três.
O Cheep consegue alterar DNS que não esteja alojado na Namecheap?
Não. O Cheep só altera o DNS de domínios que usam o DNS da Namecheap e recusa os restantes.
Feito por
Olá, sou o turushan
Criei o Cheep para gerir os meus próprios domínios. Quando uma das minhas apps ganha um site novo, o Cheep aponta o domínio dela na Namecheap para o alojamento. É grátis e de código aberto sob a licença MIT, por isso diz-me no GitHub o que ele deve fazer a seguir.
A tua próxima ideia começa com um nome.
Verifica-o a partir do terminal. Cada alteração aguarda a tua aprovação.
brew install turushan/tap/cheep Os guias estão em inglês, tal como os comandos e a saída do Cheep.