Cheep

新着Cheep 0.1.0を公開しました。Homebrew、Go、ビルド済みバイナリのいずれかでインストールできます。

オープンソース · 非公式Namecheap CLI

Namecheapを、 コマンドの速さで。

ドメインの空きを調べ、あなたのアカウントでの価格を確かめ、レビューしたプランでDNSを変更できます。ターミナルからでも、AIエージェントからでも。

Homebrewでインストール

brew install turushan/tap/cheep

macOS、Linux、Windows · MITライセンスで無料 · ほかのインストール方法

ドキュメントを読む (英語) GitHubでソースを見る
イラストで描いたムービー · 出力はサンプルデータで動かした本物のCheep

ボードを試す

名前はいくつでも、コマンドはひとつ。

名前を入力すると、確認するドメインがボードに並びます。Cheepは手元のマシンから、あなた自身のAPIキーでNamecheapに最新の結果を問い合わせます。

このページでは問い合わせを行いません。結果は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に最新の結果を問い合わせます。

お金を使うとき

本物のお金には、本気のYesを。

本番環境では、アカウントに課金されうる呼び出しは、3つのフラグを付けるまで止まります。足りないフラグはCheepが毎回はっきり示すので、うっかりしても、お金ではなく再実行1回で済みます。

  1. --yes変更を承認します。先に--dry-runを実行すれば、Cheepが送るパラメータを確認できます。
  2. --productionサンドボックスではなく、本物のアカウントへの変更であることを確認します。
  3. --accept-chargeCheepが支払いをする前に、現在の価格を確認済みであることを示します。
  • まずはサンドボックス 新しいプロファイルはNamecheapのサンドボックスから始まるので、慣れるまでのあいだ本番には何も影響しません。
  • ドライラン DNSやAPIのどんな変更にも--dry-runを付けられます。Cheepは何をするかを表示するだけで、何も変更しません。
  • キーはキーチェーンへ CheepはAPIキーをOS標準の認証情報ストアに保管し、設定ファイルには決して書き込みません。

DNS

DNSの変更は、プランを確かめてから。

Namecheapは1回の書き込みでゾーン全体を置き換えるため、Cheepはどんな変更もゾーン全体の変更として扱います。ゾーンをエクスポートし、ファイルを編集し、プランを読んでから適用する流れです。

  1. エクスポートゾーン全体を、バージョン付きのYAMLファイルに。
  2. プランすべての追加と削除を、何かが変わる前に。
  3. 適用まずスナップショットを取り、1回だけ書き込み、読み戻して確認。
  4. 復元コマンドひとつでスナップショットを戻せます。

適用では、書き込む直前に現在のゾーンをもう一度読み込み、適用中にゾーンが変わっていたら中止します。 DNSガイドを読む (英語)

AIエージェント

AIエージェントを前提に設計。

エージェントはあなたと同じコマンドを実行し、結果を安定した形式のJSONで受け取ります。データはstdoutへ、エラーはstderrへ出力され、終了コードもドキュメントに記載されています。

終了コード

0成功
1予期しないエラー
2使い方の誤り
3認証情報がない、または無効
4ネットワークエラーまたはタイムアウト
5Namecheapがエラーを返した
6競合、または結果が不明
7安全ゲートによる拒否
8課金には--accept-chargeが必要
130中断
  • --jsonコマンド、結果、使ったプロファイルを含む、バージョン付きのJSONを返します。
  • --no-input入力待ちで止まることがないので、ヘッドレス実行が固まりません。
  • --readonlyNamecheapアカウントへの変更をすべて拒否し、終了コード7を返します。

エージェントへの指示に加える一行

cheep --json --no-input --readonly domains check paperkite.dev
自動化ガイドを読む (英語)

API完全対応

Namecheap APIの全59メソッド。

普段の作業は専用コマンドでこなせます。それ以外は、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はあなたのコンピューター上で動き、NamecheapのAPIとだけ通信します。私たちのサーバーを経由するものは何もなく、あなたのキーやドメインを私たちが見ることもありません。

  • テレメトリーも、分析ツールも、アップデート確認もありません。
  • APIキーは、OS標準の認証情報ストアに保管されたままです。
  • MITライセンスのオープンソースなので、Cheepが送るリクエストをすべて自分で確かめられます。

インストール

3ステップで、最初のチェックまで。

  1. Cheepをインストール

    macOSやLinuxならHomebrewで。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が必要です。 認証ガイドを読む (英語)

よくある質問

CheepはNamecheapの公式ツールですか？

いいえ。Cheepは独立したオープンソースのツールです。Namecheapが開発、推奨、サポートしているものではありません。あなた自身のAPIキーで、Namecheapの公開APIを使います。

始めるには何が必要ですか？

Homebrew、Go、ビルド済みバイナリのいずれかで入れたCheep本体と、APIアクセスを有効にしたNamecheapアカウントです。APIユーザー、APIキー、ホワイトリストに登録したパブリックIPv4アドレスが必要になります。まずはNamecheapのサンドボックスで一通り試してください。

APIキーはどこに保存されますか？

OS標準の認証情報ストアです。macOSならキーチェーン、Windowsなら資格情報マネージャー、LinuxならSecret Serviceに入ります。サーバーでは、代わりにCHEEP_API_KEYを読み込みます。キーをコマンドの引数に書くのは絶対にやめてください。

Cheepはデータをほかの場所に送りますか？

いいえ。CheepはNamecheapのAPIとだけ通信します。テレメトリーも、アップデート確認も、私たちのサーバーもありません。

ドメインの登録、更新、移管はできますか？

はい。cheep apiを使えば、Namecheapカタログの59メソッドすべてを呼び出せます。アカウントに課金されうる呼び出しには--yesと--accept-chargeが、本番アカウントではさらに--productionが必要です。

AIエージェントにCheepを安全に使わせられますか？

はい。バージョン付きのJSONを受け取るには--json、入力待ちで止まらないようにするには--no-input、アカウントを変更させたくないときは--readonlyを渡してください。拒否された変更は終了コード7で終わります。

Cheepがサンドボックスから始まるのはなぜですか？

慣れるまでのあいだ、本番には何も影響しないようにするためです。準備ができたらプロファイルを本番に切り替えます。それでも本番での変更には--productionが必要です。

どのOSで動きますか？

macOS、Linux、Windowsで動き、IntelとARMのどちらのプロセッサにも対応しています。macOSとLinuxではHomebrewでインストールでき、どのリリースにも3つのOSすべてのバイナリがあります。

Namecheap以外でホストしているDNSも、Cheepで変更できますか？

いいえ。CheepがDNSを変更するのは、Namecheap DNSを使っているドメインだけです。それ以外は拒否します。

開発者

こんにちは、turushanです

Cheepは、自分のドメインを管理するために作りました。私のアプリに新しいサイトができると、CheepがそのNamecheapのドメインをホスティング先に向けてくれます。MITライセンスの無料オープンソースなので、次に何をしてほしいか、GitHubで教えてください。

Xでフォロー GitHubでスターを付ける 機能をリクエスト

次のアイデアは、名前から始まる。

ターミナルから確かめてみてください。どの変更も、あなたの承認を待ちます。

brew install turushan/tap/cheep
ドキュメントを読む (英語) GitHubでソースを見る

ガイドは、Cheepのコマンドや出力と同じく英語です。