Cheep

НовоеВышел Cheep 0.1.0. Установите его через Homebrew или Go либо скачайте готовую сборку.

Открытый код · Неофициальный Namecheap CLI

Namecheap со скоростью CLI.

Проверяйте домены, узнавайте цены своего аккаунта и меняйте DNS по планам, которые вы просмотрели. Из терминала или через своего AI-агента.

Установка через Homebrew

brew install turushan/tap/cheep

macOS, Linux и Windows · Бесплатно по лицензии MIT · Другие способы установки

Читать документацию (английский) Код на GitHub
Рисованный фильм · Настоящий вывод Cheep на демонстрационных данных

Попробуйте табло

Все имена одной командой.

Введите имя, и табло выстроит домены для проверки. Актуальные ответы Cheep запрашивает у Namecheap прямо на вашем компьютере, с вашим собственным API-ключом.

Эта страница ничего не проверяет. Ответы Cheep покажет в вашем терминале.

Запустите для проверки

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

Пример вывода настоящего CLI. Cheep всегда запрашивает у Namecheap актуальный ответ.

Расходы

Без чёткого «да» ни копейки.

В продакшене любой вызов, который может списать деньги с вашего аккаунта, останавливается, пока вы не добавите три флага. Cheep каждый раз называет недостающий, так что промах обойдётся повтором, а не деньгами.

  1. --yesОдобряет изменение. Сначала запустите с --dry-run, чтобы увидеть параметры, которые отправит Cheep.
  2. --productionПодтверждает, что изменение касается вашего настоящего аккаунта, а не песочницы.
  3. --accept-chargeПодтверждает, что вы проверили текущую цену, прежде чем Cheep что-либо потратит.
  • Сначала песочница Новые профили начинают в песочнице Namecheap, поэтому, пока вы учитесь, ничего настоящего не меняется.
  • Пробные запуски Добавьте --dry-run к любому изменению DNS или API. Cheep покажет, что сделал бы, и ничего не изменит.
  • Ключ под замком Cheep хранит ваш API-ключ в системном хранилище учётных данных и никогда не записывает его в свой файл настроек.

DNS

Меняйте DNS по проверенному плану.

Namecheap заменяет всю зону одним запросом, поэтому Cheep считает любую правку правкой всей зоны. Вы экспортируете зону, правите файл и читаете план, прежде чем его применить.

  1. ЭкспортВся зона в версионированном YAML-файле.
  2. ПланВсе добавления и удаления, пока ничего не изменилось.
  3. ПрименениеСначала снимок, затем один запрос на запись и контрольное чтение.
  4. ВосстановлениеВерните снимок одной командой.

Перед записью шаг применения ещё раз читает живую зону и останавливается, если она за это время изменилась. Читать руководство по DNS (английский)

AI-агенты

Создан для AI-агентов.

Ваш агент запускает те же команды, что и вы, и получает стабильную JSON-обёртку. Данные идут в stdout, ошибки в stderr, а коды выхода задокументированы.

Коды выхода

0Успех
1Непредвиденная ошибка
2Неверное использование
3Учётные данные отсутствуют или неверны
4Ошибка сети или тайм-аут
5Namecheap вернул ошибку
6Конфликт или неизвестный результат
7Отклонено защитной проверкой
8Для списания нужен --accept-charge
130Прервано
  • --jsonВерсионированная обёртка с командой, результатом и профилем, который использовался.
  • --no-inputНикогда не ждёт ввода, поэтому запуск без участия человека не зависнет.
  • --readonlyОтклоняет любые изменения в вашем аккаунте Namecheap с кодом выхода 7.

Строка для инструкций вашего агента

cheep --json --no-input --readonly domains check paperkite.dev
Читать руководство по автоматизации (английский)

Весь API

Все 59 методов API Namecheap.

Для повседневной работы есть специальные команды. Для всего остального команда cheep api даёт доступ к любому методу из официального каталога Namecheap, а каждая запись и каждое списание ждут своих флагов.

59 из 59

КомандаМетод NamecheapРежим
cheep api domainprivacy change-email-address namecheap.whoisguard.changeemailaddress запись
cheep api domainprivacy disable namecheap.whoisguard.disable запись
cheep api domainprivacy enable namecheap.whoisguard.enable запись
cheep api domainprivacy get-list namecheap.whoisguard.getlist чтение
cheep api domainprivacy renew namecheap.whoisguard.renew оплата
cheep api domains check namecheap.domains.check чтение
cheep api domains create namecheap.domains.create оплата
cheep api domains dns get-email-forwarding namecheap.domains.dns.getEmailForwarding чтение
cheep api domains dns get-hosts namecheap.domains.dns.getHosts чтение
cheep api domains dns get-list namecheap.domains.dns.getList чтение
cheep api domains dns set-custom namecheap.domains.dns.setCustom запись
cheep api domains dns set-default namecheap.domains.dns.setDefault запись
cheep api domains dns set-email-forwarding namecheap.domains.dns.setEmailForwarding запись
cheep api domains dns set-hosts namecheap.domains.dns.setHosts запись
cheep api domains get-contacts namecheap.domains.getContacts чтение
cheep api domains get-info namecheap.domains.getInfo чтение
cheep api domains get-list namecheap.domains.getList чтение
cheep api domains get-registrar-lock namecheap.domains.getRegistrarLock чтение
cheep api domains get-tld-list namecheap.domains.getTldList чтение
cheep api domains ns create namecheap.domains.ns.create запись
cheep api domains ns delete namecheap.domains.ns.delete запись
cheep api domains ns get-info namecheap.domains.ns.getInfo чтение
cheep api domains ns update namecheap.domains.ns.update запись
cheep api domains reactivate namecheap.domains.reactivate оплата
cheep api domains renew namecheap.domains.renew оплата
cheep api domains set-contacts namecheap.domains.setContacts запись
cheep api domains set-registrar-lock namecheap.domains.setRegistrarLock запись
cheep api domains transfer create namecheap.domains.transfer.create оплата
cheep api domains transfer get-list namecheap.domains.transfer.getList чтение
cheep api domains transfer get-status namecheap.domains.transfer.getStatus чтение
cheep api domains transfer update-status namecheap.domains.transfer.updateStatus запись
cheep api ssl activate namecheap.ssl.activate запись
cheep api ssl create namecheap.ssl.create оплата
cheep api ssl edit-dcv-method namecheap.ssl.editDCVMethod запись
cheep api ssl get-approver-email-list namecheap.ssl.getApproverEmailList чтение
cheep api ssl get-info namecheap.ssl.getInfo чтение
cheep api ssl get-list namecheap.ssl.getList чтение
cheep api ssl parse-csr namecheap.ssl.parseCSR чтение
cheep api ssl purchase-more-sans namecheap.ssl.purchasemoresans оплата
cheep api ssl reissue namecheap.ssl.reissue запись
cheep api ssl renew namecheap.ssl.renew оплата
cheep api ssl resend-approver-email namecheap.ssl.resendApproverEmail запись
cheep api ssl resend-fulfillment-email namecheap.ssl.resendfulfillmentemail запись
cheep api ssl revoke-certificate namecheap.ssl.revokecertificate запись
cheep api users address create namecheap.users.address.create запись
cheep api users address delete namecheap.users.address.delete запись
cheep api users address get-info namecheap.users.address.getInfo чтение
cheep api users address get-list namecheap.users.address.getList чтение
cheep api users address set-default namecheap.users.address.setDefault запись
cheep api users address update namecheap.users.address.update запись
cheep api users change-password namecheap.users.changePassword запись
cheep api users create namecheap.users.create запись
cheep api users create-add-funds-request namecheap.users.createaddfundsrequest оплата
cheep api users get-add-funds-status namecheap.users.getAddFundsStatus чтение
cheep api users get-balances namecheap.users.getBalances чтение
cheep api users get-pricing namecheap.users.getPricing чтение
cheep api users login namecheap.users.login чтение
cheep api users reset-password namecheap.users.resetPassword запись
cheep api users update namecheap.users.update запись
Читать руководство по API (английский)

Приватность

Только между вами и Namecheap.

Cheep работает на вашем компьютере и общается только с API Namecheap. Ничего не проходит через наши серверы, и мы никогда не видим ни вашего ключа, ни ваших доменов.

  • Без телеметрии, без аналитики и без проверки обновлений.
  • Ваш API-ключ остаётся в системном хранилище учётных данных.
  • Код открыт под лицензией MIT, так что каждый запрос Cheep можно изучить самому.

Установка

Первая проверка за три шага.

  1. Установите Cheep

    Через Homebrew на macOS или Linux, через Go 1.26.10 и новее либо в виде готовой сборки для macOS, Linux или Windows.

    brew install turushan/tap/cheep

    Или через Go версии 1.26.10 и новее

    go install github.com/turushan/cheep/cmd/cheep@latest
    Скачать готовую сборку
  2. Подключите песочницу

    Заведите в песочнице Namecheap пользователя API и ключ, а свой публичный IPv4 добавьте в белый список. Сохраните профиль, запишите ключ в хранилище и проверьте всё командой doctor.

    cheep --environment sandbox auth configure sandbox --api-user YOUR_SANDBOX_USER --client-ip YOUR_PUBLIC_IPV4 --default
    cheep auth set-key
    cheep doctor
  3. Проверьте свои имена

    Проверяйте сколько угодно имён одной командой.

    cheep domains check paperkite.dev paperkite.com

Namecheap требует пользователя API, API-ключ и публичный IPv4 в белом списке. Без них не сработает ни одна команда. Читать руководство по аутентификации (английский)

Вопросы

Это официальный инструмент Namecheap?

Нет. Cheep разрабатывается независимо, и его код открыт. Namecheap его не создаёт, не одобряет и не поддерживает. Cheep работает через публичный API Namecheap с вашим собственным API-ключом.

Что нужно для начала?

Сам Cheep из Homebrew, через Go или в виде готовой сборки, а ещё аккаунт Namecheap с доступом к API: пользователь API, API-ключ и публичный IPv4-адрес в белом списке. Сначала попробуйте всё в песочнице Namecheap.

Где хранится мой API-ключ?

В системном хранилище учётных данных: в «Связке ключей» на macOS, в «Диспетчере учётных данных» на Windows и в Secret Service на Linux. На серверах Cheep вместо этого читает CHEEP_API_KEY. Никогда не передавайте ключ в аргументе команды.

Cheep отправляет мои данные куда-то ещё?

Нет. Cheep общается только с API Namecheap. У него нет телеметрии, проверки обновлений и наших серверов.

Он умеет регистрировать, продлевать и переносить домены?

Да, через команду cheep api, которая открывает все 59 методов каталога Namecheap. Вызову, который может списать деньги с аккаунта, нужны --yes и --accept-charge, а на настоящем аккаунте ещё и --production.

Может ли мой AI-агент безопасно работать с Cheep?

Да. Дайте ему --json для версионированной обёртки, --no-input, чтобы он никогда не ждал ввода, и --readonly, когда ему нельзя менять ваш аккаунт. Отклонённое изменение завершается с кодом 7.

Почему Cheep начинает с песочницы?

Чтобы ничего настоящего не менялось, пока вы учитесь. Когда будете готовы, переключите профиль на продакшен. Изменения там всё равно потребуют --production.

На каких системах он работает?

На macOS, Linux и Windows, с процессорами Intel и ARM. Homebrew ставит его на macOS и Linux, а в каждом релизе есть сборки для всех трёх систем.

Может ли Cheep менять DNS, размещённый не у Namecheap?

Нет. Cheep меняет DNS только у доменов, которые используют DNS Namecheap, а остальные отклоняет.

Автор

Привет, я turushan

Я сделал Cheep для своих доменов. Когда у одного из моих приложений появляется новый сайт, Cheep привязывает его домен в Namecheap к хостингу. Он бесплатен, а код открыт под лицензией MIT, так что напишите мне на GitHub, чему его научить дальше.

Подписаться в X Поставить звезду Предложить функцию

Ваша следующая идея начинается с имени.

Проверьте его из терминала. Каждое изменение ждёт вашего одобрения.

brew install turushan/tap/cheep
Читать документацию (английский) Код на GitHub

Руководства написаны на английском, как и команды и вывод Cheep.