pp-cf-domain

Cf Domain — Printing Press CLI

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

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

1. Printing Press インストーラーでインストールします。デフォルトのバイナリ保存先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

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

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

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

go install github.com/mvanhorn/printing-press-library/library/cloud/cf-domain/cmd/cf-domain-pp-cli@latest

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

コマンドリファレンス

registrar — レジストラを管理します

• cf-domain-pp-cli registrar domain-check — ドメインの空き状況と価格をリアルタイムで確認します。登録の直前に必ず実行してください。
• cf-domain-pp-cli registrar domain-register — アカウントのデフォルトの登録者／支払い設定を使って、Cloudflare Registrar 経由でドメインを登録します。危険な操作です：呼び出し元...
• cf-domain-pp-cli registrar domain-search — Cloudflare Registrar でドメイン候補と空き状況のヒントを検索します。最終的な価格をリアルタイムで確認するには domain-check を使用してください...

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

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

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

which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は一致する候補が少なくとも 1 つあることを示し、終了コード 2 は確信を持てる候補がないことを示します。その場合は --help にフォールバックするか、より具体的な問い合わせを使用してください。

認証の設定

cf-domain-pp-cli auth setup を実行すると、トークンを取得するための URL と手順が表示されます（URL を開くには --launch を追加します）。次に、トークンを保存します。

cf-domain-pp-cli auth set-token YOUR_TOKEN_HERE

または、環境変数 CLOUDFLARE_REGISTRAR_DOMAINS_BEARER_AUTH を設定します。

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

エージェントモード

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

• パイプ対応 — stdout に JSON、stderr にエラーを出力します

• フィルター対応 — --select でフィールドの一部を保持します。ドット区切りのパスはネストされた構造に進み、配列では各要素を走査します。詳細な API のコンテキストを小さく保つうえで重要です。

  cf-domain-pp-cli registrar domain-check mock-value --domain-name example-resource --agent --select id,name,status
  

• プレビュー可能 — --dry-run で、送信せずにリクエストを表示します

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

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

• 明示的な再試行 — すでに存在するリソースの作成を成功として扱う場合に限り、--idempotent を使用します

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を出典情報のエンベロープで囲みます。

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

データの取得には .results を解析し、データがライブかローカルかを把握するには .meta.source を確認してください。人が読める N results (live) の概要は、stdout がターミナルの場合に限り stderr に出力されます。パイプやエージェントの利用者には、stdout に純粋な JSON が出力されます。

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

この CLI について気になる点があった場合は、（エージェントが気づいた場合も）記録してください。

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

記録はローカルの ~/.cf-domain-pp-cli/feedback.jsonl に保存されます。CF_DOMAIN_FEEDBACK_ENDPOINT が設定されており、かつ --send が渡されている場合、または CF_DOMAIN_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトの動作はローカル保存のみです。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で。それが積み重なっていきます。

出力先

すべてのコマンドで --deliver <sink> を指定できます。出力は、標準出力に加えて（または標準出力の代わりに）指定した出力先に送られるため、エージェントはコマンド結果を手作業でパイプに渡さずに振り分けられます。次の3つの出力先に対応しています。

出力先	効果
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイルを作成してから名前を変更）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、サポートされているスキームを示す構造化エラーとともに拒否されます。Webhook への送信に失敗すると、ゼロ以外の終了コードが返され、URL と HTTP ステータスが標準エラーに記録されます。

名前付きプロファイル

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

cf-domain-pp-cli profile save briefing --json
cf-domain-pp-cli --profile briefing registrar domain-check mock-value --domain-name example-resource
cf-domain-pp-cli profile list --json
cf-domain-pp-cli profile show briefing
cf-domain-pp-cli profile delete briefing --yes

明示的に指定したフラグは、常にプロファイルの値より優先されます。プロファイルの値はデフォルト値より優先されます。agent-context は、実行時に情報を調べるエージェントがプロファイルを見つけられるよう、すべての利用可能なプロファイルを available_profiles に一覧表示します。

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

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

claude mcp add cf-domain-pp-mcp -- cf-domain-pp-mcp

確認：claude mcp list

直接使用

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

   cf-domain-pp-cli <command> [subcommand] [args] --agent
   

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