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

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

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

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.

  1. --yesAprova a alteração. Executa primeiro --dry-run para veres os parâmetros que o Cheep enviaria.
  2. --productionConfirma que a alteração é para a tua conta real, e não para a sandbox.
  3. --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.

  1. ExportaA zona completa, num ficheiro YAML versionado.
  2. PlaneiaCada adição e remoção, antes de qualquer alteração.
  3. AplicaPrimeiro um snapshot, depois uma única escrita e uma releitura de confirmação.
  4. 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

0Sucesso
1Erro inesperado
2Erro de utilização
3Credenciais em falta ou inválidas
4Erro de rede ou tempo esgotado
5A Namecheap devolveu um erro
6Conflito ou resultado desconhecido
7Recusado por um bloqueio 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 à 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
Ler o guia de automatização (inglês)

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

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 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.

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

    Ou com Go 1.26.10 ou posterior

    go install github.com/turushan/cheep/cmd/cheep@latest
    Descarregar um binário pré-compilado
  2. 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 --default
    cheep auth set-key
    cheep doctor
  3. 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.