NovidadeO Cheep 0.1.0 já está disponível. Instale 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.

Verifique domínios, consulte os preços da sua conta e altere o DNS com planos revisados, pelo terminal ou pelo seu 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

Filme ilustrado · Saída real do Cheep com dados de exemplo

Experimente o painel

Todos os nomes em um só comando.

Digite um nome e o painel enfileira os domínios a verificar. O Cheep pede as respostas em tempo real à Namecheap, no seu próprio computador e com a sua própria chave de API.

Esta página não faz nenhuma consulta. O Cheep mostra as respostas no seu terminal.

Rode este comando para verificá-los

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

Saída de exemplo da CLI real. O Cheep sempre pede a resposta em tempo real à Namecheap.

Gastar dinheiro

Dinheiro de verdade exige um sim de verdade.

Em produção, qualquer chamada que possa gerar cobrança na sua conta fica parada até você adicionar três flags. O Cheep diz qual falta toda vez, então um deslize custa uma nova tentativa, e não dinheiro.

  1. --yesAprova a mudança. Rode --dry-run antes para ver os parâmetros que o Cheep enviaria.
  2. --productionConfirma que a mudança é para a sua conta real, não para a sandbox.
  3. --accept-chargeConfirma que você conferiu o preço atual antes de o Cheep gastar qualquer coisa.
  • Primeiro, a sandbox Perfis novos começam na sandbox da Namecheap, então nada real muda enquanto você aprende.
  • Simulações Adicione --dry-run a qualquer mudança de DNS ou da API. O Cheep mostra o que faria e não muda nada.
  • Chaves no seu chaveiro O Cheep guarda sua chave de API no gerenciador de credenciais do sistema operacional, nunca no arquivo de configuração.

DNS

Altere o DNS com um plano revisado.

A Namecheap reescreve a zona inteira de uma vez, então o Cheep trata cada mudança como uma mudança na zona toda. Você exporta a zona, edita o arquivo e lê o plano antes de aplicá-lo.

  1. ExporteA zona completa, em um arquivo YAML versionado.
  2. PlanejeCada inclusão e remoção, antes de qualquer mudança.
  3. ApliquePrimeiro um snapshot, depois uma única escrita e uma releitura para conferir.
  4. RestaureVolte a um snapshot com um só comando.

Ao aplicar, o Cheep relê a zona atual logo antes de escrever e interrompe tudo se ela tiver mudado no meio do caminho. Ler o guia de DNS (inglês)

Agentes de IA

Feito para agentes de IA.

Seu agente roda os mesmos comandos que você, 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

0Sucesso
1Erro inesperado
2Erro de uso
3Credenciais ausentes ou inválidas
4Erro de rede ou tempo esgotado
5A Namecheap retornou um erro
6Conflito ou resultado desconhecido
7Recusado por uma trava de segurança
8Uma cobrança precisa de --accept-charge
130Interrompido
  • --jsonUm envelope versionado com o comando, o resultado e o perfil usado.
  • --no-inputNunca fica esperando uma resposta, então uma execução sem supervisão não tem como travar.
  • --readonlyRecusa qualquer mudança na sua conta da Namecheap, com o código de saída 7.

Uma linha para as instruções do seu agente

cheep --json --no-input --readonly domains check paperkite.dev
Ler o guia de automação (inglês)

API completa

Todos os 59 métodos da API da Namecheap.

Comandos dedicados cobrem o trabalho do dia a dia. Para todo o resto, o cheep api alcança todos os métodos do catálogo oficial da Namecheap, e cada escrita ou cobrança espera as suas flags.

59 de 59

ComandoMétodo da NamecheapModo
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
Ler o guia da API (inglês)

Privacidade

Entre você e a Namecheap.

O Cheep roda no seu computador e só fala com a API da Namecheap. Nada passa por um servidor nosso, e nunca vemos sua chave nem seus domínios.

  • Sem telemetria, sem ferramentas de análise e sem verificação de atualizações.
  • Sua chave de API fica no gerenciador de credenciais do sistema operacional.
  • Código aberto sob a licença MIT, então você pode ler cada requisição que ele faz.

Instalação

Sua primeira verificação em três passos.

  1. Instale 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/cheep

    Ou com Go 1.26.10 ou posterior

    go install github.com/turushan/cheep/cmd/cheep@latest
    Baixar um binário pré-compilado
  2. Conecte a sandbox

    Crie na sandbox da Namecheap um usuário de API, uma chave e um IPv4 público na lista de permissões. Salve o perfil, guarde a chave e deixe o doctor conferir tudo.

    cheep --environment sandbox auth configure sandbox --api-user YOUR_SANDBOX_USER --client-ip YOUR_PUBLIC_IPV4 --default
    cheep auth set-key
    cheep doctor
  3. Verifique seus nomes

    Consulte quantos nomes quiser em um só comando.

    cheep domains check paperkite.dev paperkite.com

A Namecheap exige um usuário de API, uma chave de API e um IPv4 público na lista de permissões antes que qualquer comando funcione. 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 endossa e não oferece suporte a ele. Ele usa a API pública da Namecheap com a sua própria chave de API.

Do que eu preciso para começar?

Do próprio Cheep, pelo Homebrew, pelo Go ou como binário pré-compilado, e de uma conta da Namecheap com acesso à API: um usuário de API, uma chave de API e um endereço IPv4 público na lista de permissões. Teste tudo primeiro na sandbox da Namecheap.

Onde fica minha chave de API?

No gerenciador de credenciais do seu sistema operacional: o Acesso às Chaves no macOS, o Gerenciador de Credenciais no Windows e o Secret Service no Linux. Em servidores, o Cheep lê CHEEP_API_KEY em vez disso. Nunca coloque a chave em um argumento de comando.

O Cheep envia meus dados para algum outro lugar?

Não. O Cheep só fala com a API da Namecheap. Ele não tem telemetria, verificação de atualizações nem servidores nossos.

Ele consegue registrar, renovar e transferir domínios?

Sim, pelo cheep api, que alcança os 59 métodos do catálogo da Namecheap. Uma chamada que possa gerar cobrança na sua conta precisa de --yes e --accept-charge, além de --production na sua conta real.

Meu agente de IA pode usar o Cheep com segurança?

Sim. Passe --json para receber um envelope versionado, --no-input para ele nunca ficar esperando uma resposta e --readonly quando ele não puder mudar sua conta. Uma mudança recusada sai com o código 7.

Por que o Cheep começa na sandbox?

Para que nada real mude enquanto você aprende. Quando chegar a hora, você muda um perfil para produção, e as mudanças em produção continuam precisando de --production.

Em quais sistemas ele roda?

macOS, Linux e Windows, em processadores Intel e ARM. O Homebrew instala no macOS e no Linux, e cada versão traz binários para os três.

O Cheep consegue alterar um DNS que não está hospedado na Namecheap?

Não. O Cheep só altera o DNS de domínios que usam o DNS da Namecheap e recusa os demais.

Feito por

Oi, eu sou o turushan

Criei o Cheep para os meus próprios domínios. Quando um dos meus apps ganha um site novo, o Cheep aponta o domínio dele na Namecheap para a hospedagem. É grátis e de código aberto sob a licença MIT, então me conte no GitHub o que ele deve fazer a seguir.

Sua próxima ideia começa com um nome.

Verifique pelo seu terminal. Toda mudança aguarda a sua aprovação.

brew install turushan/tap/cheep

Os guias estão em inglês, assim como os comandos e a saída do Cheep.