pp-namecheap

Namecheap — Printing Press CLI

前提条件：CLI をインストールする

このスキルは namecheap-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。 インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使ってインストールします。デフォルトでは、macOS/Linux の場合は $HOME/.local/bin、Windows の場合は %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリがインストールされます。

   npx -y @mvanhorn/printing-press-library install namecheap --cli-only
   

2. 次のコマンドで確認します：namecheap-pp-cli --version
3. 報告されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go で直接インストールしてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/developer-tools/namecheap/cmd/namecheap-pp-cli@latest

インストール後に --version が「command not found」と報告する場合、ランタイムからバイナリディレクトリが $PATH 経由で見えていません。確認が完了するまで、スキルのコマンドを実行しないでください。

この CLI を使用しない場合

作成、更新、削除、公開、コメント投稿、賛成票の投票、招待、注文、メッセージ送信、予約、購入、またはリモートの状態変更を必要とするリクエストでは、この CLI を有効にしないでください。この Printing Press CLI が公開するのは、調査、エクスポート、同期、分析用の読み取り専用コマンドです。

コマンドリファレンス

dns — DNS を管理する

• namecheap-pp-cli dns get-email-forwarding — namecheap.domains.dns.getEmailForwarding を実行します。
• namecheap-pp-cli dns get-hosts — namecheap.domains.dns.getHosts を実行します。
• namecheap-pp-cli dns get-list — DNS ネームサーバーの種類とネームサーバーを取得します。
• namecheap-pp-cli dns set-custom — namecheap.domains.dns.setCustom を実行します。
• namecheap-pp-cli dns set-default — ドメインを Namecheap のデフォルト DNS に切り替えます。
• namecheap-pp-cli dns set-hosts — namecheap.domains.dns.setHosts を実行します。HostName1/RecordType1/Address1/TTL1 形式のパラメーターは、以下を使って渡せます...

domains — ドメインを管理する

• namecheap-pp-cli domains check — 1 つ以上のドメインの利用可能状況を確認します。
• namecheap-pp-cli domains create — namecheap.domains.create を実行します。料金が発生する変更操作です。意図的に登録する場合を除き、ドライランを使用してください。
• namecheap-pp-cli domains get-contacts — namecheap.domains.getContacts を実行します。
• namecheap-pp-cli domains get-info — ドメインについて namecheap.domains.getInfo を実行します。
• namecheap-pp-cli domains get-list — ページネーションと任意のフィルターを指定して namecheap.domains.getList を実行します。
• namecheap-pp-cli domains get-registrar-lock — namecheap.domains.getRegistrarLock を実行します。
• namecheap-pp-cli domains get-tld-list — namecheap.domains.getTldList を実行します。
• namecheap-pp-cli domains renew — namecheap.domains.renew を実行します。料金が発生する変更操作です。
• namecheap-pp-cli domains set-registrar-lock — namecheap.domains.setRegistrarLock を実行します。

ssl — SSL を管理する

• namecheap-pp-cli ssl get-info — SSL 証明書情報を取得します。
• namecheap-pp-cli ssl get-list — namecheap.ssl.getList を実行します。
• namecheap-pp-cli ssl parse-csr — 証明書署名要求を解析します。

users — ユーザーを管理する

• namecheap-pp-cli users address-get-info — namecheap.users.address.getInfo を実行します。
• namecheap-pp-cli users address-get-list — namecheap.users.address.getList を実行します。
• namecheap-pp-cli users get-balances — namecheap.users.getBalances を実行します。
• namecheap-pp-cli users get-pricing — namecheap.users.getPricing を実行します。

適切なコマンドを見つける

実行したいことは分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接問い合わせてください。

namecheap-pp-cli which "<capability in your own words>"

which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は 1 つ以上の一致があることを示し、終了コード 2 は確度の高い一致がないことを示します。一致がない場合は --help を使うか、より範囲を絞った問い合わせをしてください。

認証の設定

namecheap-pp-cli auth setup を実行すると、キーの取得先 URL と手順が表示されます（--launch を追加すると URL が開きます）。次に、以下を設定します。

export NAMECHEAP_API_KEY="<your-key>"

または、~/.config/namecheap-pp-cli/config.toml に保存します。

namecheap-pp-cli doctor を実行して、設定を確認します。

エージェントモード

任意のコマンドに --agent を追加します。次のフラグに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout には JSON、stderr にはエラーが出力されます

• フィルター可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列は各要素を順にたどります。詳細な API のコンテキストを小さく保つために重要です：

  namecheap-pp-cli dns get-email-forwarding --agent --select id,name,status
  

• プレビュー可能 — --dry-run でリクエストを送信せずに内容を確認できます

• オフラインで利用可能 — 同期／検索コマンドでは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力をフラグで指定します

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票の投票、招待、注文、送信など、状態を変更するリクエストにはこの CLI を使用しないでください

レスポンスのエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力をプロベナンスエンベロープでラップします：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人が読める N results (live) の概要は、stdout がターミナルで、かつ機械向けフォーマットのフラグ（--json、--csv、--compact、--quiet、--plain、--select）が指定されていない場合にのみ stderr に出力されます。パイプやエージェントからの利用、および明示的にフォーマットを指定した実行では、stdout に JSON のみが出力されます。

エージェントからのフィードバック

この CLI の問題に気づいた場合（エージェントが気づいた場合も含む）は、記録してください：

namecheap-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
namecheap-pp-cli feedback --stdin < notes.txt
namecheap-pp-cli feedback list --json --limit 10

エントリーはローカルの ~/.namecheap-pp-cli/feedback.jsonl に保存されます。NAMECHEAP_FEEDBACK_ENDPOINT が設定され、かつ --send が指定されているか、NAMECHEAP_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトではローカルにのみ保存されます。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で記録してください。その積み重ねが役立ちます。

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は stdout に加えて（または stdout の代わりに）指定したシンクに送られるため、エージェントはコマンド結果を手動でパイプせずに振り分けられます。サポートされているシンクは 3 種類です：

シンク	動作
stdout	デフォルト。stdout のみに出力
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、サポート対象の一覧を示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードが返され、URL と HTTP ステータスが stderr に記録されます。

名前付きプロファイル

プロファイルは保存済みのフラグ値のセットで、呼び出しごとに再利用できます。スケジュールされたエージェントが同じ設定で同じコマンドを毎回実行する場合に使用します。これは HeyGen の「Beacon」パターンです。

namecheap-pp-cli profile save briefing --json
namecheap-pp-cli --profile briefing dns get-email-forwarding
namecheap-pp-cli profile list --json
namecheap-pp-cli profile show briefing
namecheap-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイル値より優先され、プロファイル値はデフォルトより優先されます。agent-context は、実行時に内容を確認するエージェントが利用できるよう、すべてのプロファイルを available_profiles に一覧表示します。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が不正）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中（待ってから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します：

1. 空、help、または --help → namecheap-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の「前提条件」を参照します
3. その他 → 直接使用（--agent を付けて CLI コマンドを実行します）

MCP サーバーのインストール

この CLI の公開済み public-library エントリーまたはビルド済みリリースから MCP バイナリをインストールし、登録します：

claude mcp add namecheap-pp-mcp -- namecheap-pp-mcp

確認します：claude mcp list

直接使用

1. インストール済みか確認します：which namecheap-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある「前提条件」を参照してください）。
2. ユーザーの問い合わせに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
3. --agent フラグを付けて実行します：

   namecheap-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認します：namecheap-pp-cli <command> --help。