mcpField
P
pp-vercel-admin

pp-vercel-admin

github.com/mvanhornクラウド・DevOps2.1k64 回インストール今日更新
リポジトリ

pp-vercel-admin について

pp-vercel-admin は、Printing Press CLI で Vercel を管理するスキルです。デプロイ、ドメイン、請求、アクセスグループなどの管理に対応します。

主な機能

  1. 01デプロイとドメインの管理
  2. 02アクセスグループの作成と編集
  3. 03請求情報の確認と管理
  4. 04エッジとネットワークの設定

活用シーン

  1. 01チームのデプロイ状況の確認
  2. 02ドメインや DNS 設定の更新
  3. 03チームのアクセスグループ管理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-vercel-admin

インストール後、Claude Code で/pp-vercel-adminを入力して読み込まれたか確認します。

詳細

Vercel Admin — Printing Press CLI

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

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

  1. Printing Press インストーラーを使用してインストールします。macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin がバイナリのデフォルトのインストール先です。
    npx -y @mvanhorn/printing-press-library install vercel-admin --cli-only
    
  2. 確認します:vercel-admin-pp-cli --version
  3. 報告されたインストール先のディレクトリが、このスキルを実行するエージェント/ランタイムの $PATH に含まれていることを確認します。

npx によるインストールに失敗した場合(Node がない、オフラインなど)は、Go を直接インストールする方法に切り替えてください(Go 1.26.6 以降が必要です)。この方法では $GOPATH/bin(デフォルトは $HOME/go/bin)にインストールされるため、代わりにこのディレクトリを $PATH に追加してください。

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

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

Vercel は、優れた開発者体験とエンドユーザーのパフォーマンスへの徹底したこだわりを両立させています。Vercel のプラットフォームにより、フロントエンドチームは最高の仕事ができます。

コマンドリファレンス

access-groups — アクセスグループを管理します

  • vercel-admin-pp-cli access-groups create — アクセスグループを作成します
  • vercel-admin-pp-cli access-groups delete — アクセスグループを削除します
  • vercel-admin-pp-cli access-groups list — チーム、プロジェクト、またはメンバーのアクセスグループを一覧表示します
  • vercel-admin-pp-cli access-groups read — アクセスグループを読み取ります
  • vercel-admin-pp-cli access-groups update — アクセスグループのメタデータを更新します

aliases — エイリアスを管理します

  • vercel-admin-pp-cli aliases delete-alias — 指定した ID のエイリアスを削除します。
  • vercel-admin-pp-cli aliases get-alias — 指定したホスト名またはエイリアス ID のエイリアスを取得します。
  • vercel-admin-pp-cli aliases list — 認証済みユーザーまたはチームのエイリアス一覧を取得します。

artifacts — アーティファクトを管理します

  • vercel-admin-pp-cli artifacts download — リクエストパスで指定された hash によって識別されるキャッシュアーティファクトをダウンロードします。
  • vercel-admin-pp-cli artifacts exists — 指定した hash のキャッシュアーティファクトが存在することを確認します。
  • vercel-admin-pp-cli artifacts query — アーティファクトの配列に関する情報を照会します。
  • vercel-admin-pp-cli artifacts record-events — アーティファクトのキャッシュ使用イベントを記録します。このリクエストの本文は、キャッシュ使用イベントの配列です。
  • vercel-admin-pp-cli artifacts status — このプリンシパルのリモートキャッシュのステータスを確認します。
  • vercel-admin-pp-cli artifacts upload — パスで指定された hash によって識別されるキャッシュアーティファクトをアップロードします。

billing — 請求を管理します

  • vercel-admin-pp-cli billing buy-credits — 登録済みのデフォルトの支払い方法を使用して、Vercel チームのクレジットを購入します。
  • vercel-admin-pp-cli billing list-charges — FOCUS v1 形式の請求額データを返します。
  • vercel-admin-pp-cli billing list-contract-commitments — 指定した Vercel チームについて、契約期間ごとのコミットメント割り当てを FOCUS v1.3 JSONL 形式で返します。

bulk-redirects — 一括リダイレクトを管理します

  • vercel-admin-pp-cli bulk-redirects delete-redirects — プロジェクトの一括リダイレクトの最新バージョンから、指定したリダイレクトを削除します。
  • vercel-admin-pp-cli bulk-redirects edit-redirect — ソースパスで識別される単一のリダイレクトを編集します。
  • vercel-admin-pp-cli bulk-redirects get-redirects — プロジェクトの一括リダイレクトのバージョン履歴を取得します
  • vercel-admin-pp-cli bulk-redirects get-versions — プロジェクトの一括リダイレクトのバージョン履歴を取得します
  • vercel-admin-pp-cli bulk-redirects restore-redirects — ステージングバージョンの指定したリダイレクトを、本番バージョンの値に戻します。
  • vercel-admin-pp-cli bulk-redirects stage-redirects — プロジェクトに新しいリダイレクトをステージングし、新しいバージョンを返します。
  • vercel-admin-pp-cli bulk-redirects update-version — ステージングを本番に昇格するか、以前の本番バージョンを復元してバージョンを更新します

certs — 証明書を管理します

  • vercel-admin-pp-cli certs get-by-id — ID で証明書を取得します
  • vercel-admin-pp-cli certs issue — 新しい証明書を発行します
  • vercel-admin-pp-cli certs remove — 証明書を削除します
  • vercel-admin-pp-cli certs upload — 証明書をアップロードします

connect — Connect を管理します

  • vercel-admin-pp-cli connect create-connector — 種類固有の設定からコネクターを作成し、作成時にプロジェクトへリンクすることもできます。
  • vercel-admin-pp-cli connect create-connector-authorization-request — コネクターの認可リクエストを作成し、フローの完了に必要な URL と検証情報を返します。
  • vercel-admin-pp-cli connect create-network — Secure Compute ネットワークを作成できます。
  • vercel-admin-pp-cli connect delete-network — Secure Compute ネットワークを削除できます。
  • vercel-admin-pp-cli connect get-connector-token — パスパラメーターで識別され、リクエスト元にスコープされたコネクターのアクセストークンを取得します。
  • vercel-admin-pp-cli connect list-networks — Secure Compute ネットワークの一覧を取得できます。
  • vercel-admin-pp-cli connect read-network — Secure Compute ネットワークを読み取ることができます。
  • vercel-admin-pp-cli connect update-network — Secure Compute ネットワークを更新できます。

deployments — デプロイメントを管理します

  • vercel-admin-pp-cli deployments create — 必須データと指定されたデータをすべて含む新しいデプロイメントを作成します。
  • vercel-admin-pp-cli deployments delete — この API を使用すると、デプロイメントを削除できます
  • vercel-admin-pp-cli deployments get — 認証済みのユーザーまたはチームのデプロイメント一覧を取得します。
  • vercel-admin-pp-cli deployments get-idorurl — ID(id プロパティ)またはホスト名(url プロパティ)を指定して、デプロイメントの情報を取得します。

domains — ドメインを管理します

  • vercel-admin-pp-cli domains create-or-transfer — 認証ユーザーの Vercel に新しいエイペックスドメイン名を追加するためのエンドポイントです。
  • vercel-admin-pp-cli domains delete — Vercel に登録済みのドメイン名を削除します。
  • vercel-admin-pp-cli domains get — 認証済みのユーザーまたはチームに登録されているドメインの一覧を取得します。
  • vercel-admin-pp-cli domains get-domain — アカウントまたはチーム内の単一ドメインの情報を取得します。
  • vercel-admin-pp-cli domains patch — エイペックスドメインを更新または移動します。注:このエンドポイントは、自動更新やネームサーバーの更新には使用されなくなりました。
  • vercel-admin-pp-cli domains update-record — ドメイン名の既存の DNS レコードを更新します。

drains — Drain を管理します

  • vercel-admin-pp-cli drains create — 指定した設定で新しい Drain を作成します。

  • vercel-admin-pp-cli drains delete — URL に Drain ID を指定して、特定の Drain を削除します。

  • vercel-admin-pp-cli drains get — 認証済みチームの Drain 一覧を取得できます。

  • vercel-admin-pp-cli drains get-id — URL に Drain ID を指定して、特定の Drain の情報を取得します。

  • vercel-admin-pp-cli drains test — サンプルイベントを使用して、Drain の配信設定を検証します。

  • vercel-admin-pp-cli drains update — 既存の Drain の設定を更新します。 edge-cache — エッジキャッシュを管理

  • vercel-admin-pp-cli edge-cache dangerously-delete-by-src-images — ソース画像を削除済みとしてマークします

  • vercel-admin-pp-cli edge-cache dangerously-delete-by-tags — キャッシュタグを削除済みとしてマークします

  • vercel-admin-pp-cli edge-cache invalidate-by-src-images — ソース画像を古い状態としてマークします

  • vercel-admin-pp-cli edge-cache invalidate-by-tags — キャッシュタグを古い状態としてマークします

edge-config — エッジ設定を管理

  • vercel-admin-pp-cli edge-config create — Edge Config を作成します。
  • vercel-admin-pp-cli edge-config delete — ID を指定して Edge Config を削除します。
  • vercel-admin-pp-cli edge-config get — すべての Edge Config を返します。
  • vercel-admin-pp-cli edge-config get-edgeconfig — Edge Config を返します。
  • vercel-admin-pp-cli edge-config update — Edge Config を更新します。

env — 環境変数を管理

  • vercel-admin-pp-cli env create-shared-variable — チームの共有環境変数を作成します。
  • vercel-admin-pp-cli env delete-shared-variable — 指定したチームの共有環境変数を1つまたは複数削除します。
  • vercel-admin-pp-cli env get-shared-var — ID を指定して共有環境変数の復号済みの値を取得します。
  • vercel-admin-pp-cli env list-shared-variable — オプションのフィルターを適用して、チームの共有環境変数をすべて一覧表示します。
  • vercel-admin-pp-cli env update-shared-variable — 指定したチームの共有環境変数を更新します。

events — イベントを管理

  • vercel-admin-pp-cli events list-types — ユーザー向けイベントタイプの一覧と説明を返します。
  • vercel-admin-pp-cli events list-user — Vercel 上でユーザーが生成した「イベント」の一覧を取得します。

files — ファイルを管理

  • vercel-admin-pp-cli files — デプロイを作成する前に、そのデプロイに必要なファイルをアップロードする必要があります。

installations — インストールを管理

  • vercel-admin-pp-cli installations <integrationConfigurationId> — インテグレーションのインストールを更新します。

integrations — インテグレーションを管理

  • vercel-admin-pp-cli integrations connect-resource-to-project — インテグレーションのリソースを Vercel プロジェクトに接続します。
  • vercel-admin-pp-cli integrations create-log-drain — インテグレーションのログドレインを作成します。
  • vercel-admin-pp-cli integrations delete-configuration — パラメーターで指定された id の設定を削除します。
  • vercel-admin-pp-cli integrations delete-log-drain — 指定された id のインテグレーションログドレインを削除します。
  • vercel-admin-pp-cli integrations exchange-sso-token — 認証プロセス中に、Vercel はユーザーをプロバイダーの [redirectLoginUrl](https://vercel にリダイレクトします。
  • vercel-admin-pp-cli integrations get-billing-plans — インテグレーションと製品の課金プラン一覧を取得します。
  • vercel-admin-pp-cli integrations get-configuration — 指定された ID の設定が存在する場合、その設定を取得します。
  • vercel-admin-pp-cli integrations get-configuration-products — インテグレーション設定で利用可能な製品を返します。
  • vercel-admin-pp-cli integrations get-configurations — 認証済みインテグレーションのすべての設定を取得します。
  • vercel-admin-pp-cli integrations get-log-drains — 認証済みユーザーまたはチームに定義されているインテグレーションログドレインの一覧を取得します。
  • vercel-admin-pp-cli integrations git-namespaces — サポート対象プロバイダーの Git 名前空間を一覧表示します。サポート対象プロバイダーは github、gitlab、bitbucket です。
  • vercel-admin-pp-cli integrations search-repo — サポート対象プロバイダーの名前空間 id にリンクされた Git リポジトリを一覧表示します。

log-drains — ログドレインを管理

  • vercel-admin-pp-cli log-drains create-configurable — 設定可能なログドレインを作成します。

  • vercel-admin-pp-cli log-drains delete-configurable — 設定可能なログドレインを削除します。

  • vercel-admin-pp-cli log-drains get-all — アカウントが所有するすべてのログドレインの一覧を取得します。

  • vercel-admin-pp-cli log-drains get-configurable — 設定可能なログドレインを取得します。 microfrontends — マイクロフロントエンドを管理

  • vercel-admin-pp-cli microfrontends create-group-with-applications — マイクロフロントエンドグループを作成し、1 回のリクエストで複数のプロジェクトを追加します。

  • vercel-admin-pp-cli microfrontends get-config-for-project — ID または名前で指定したプロジェクトのマイクロフロントエンド設定を取得します。

  • vercel-admin-pp-cli microfrontends get-groups — チームのマイクロフロントエンドグループ ID を取得します。

  • vercel-admin-pp-cli microfrontends get-in-group — 指定したグループ ID のマイクロフロントエンドを取得します。

observability — オブザーバビリティを管理

  • vercel-admin-pp-cli observability get-configuration-projects — チームで Observability Plus が無効に設定されているプロジェクトの一覧を取得します。
  • vercel-admin-pp-cli observability update-configuration-project — 1 つのプロジェクトで Observability Plus を無効にするかどうかを更新します。

projects — プロジェクトを管理

  • vercel-admin-pp-cli projects accept-transfer-request — 別のチームが開始したプロジェクトの移管リクエストを承認します。
  • vercel-admin-pp-cli projects create — 指定した設定で新しいプロジェクトを作成します。
  • vercel-admin-pp-cli projects delete — URL にプロジェクトの id または name を指定して、特定のプロジェクトを削除します。
  • vercel-admin-pp-cli projects get — 認証済みユーザーまたはチームのプロジェクト一覧を取得します。
  • vercel-admin-pp-cli projects get-idorname — URL にプロジェクトの id または name を指定して、特定のプロジェクトの情報を取得します。
  • vercel-admin-pp-cli projects update — プロジェクトの name または id を使って、そのフィールドを更新します。

registrar — レジストラを管理

  • vercel-admin-pp-cli registrar buy-domains — 複数のドメインを一度に購入します
  • vercel-admin-pp-cli registrar buy-single-domain — ドメインを購入します
  • vercel-admin-pp-cli registrar get-bulk-availability — 複数のドメインの利用可否を取得します。
  • vercel-admin-pp-cli registrar get-contact-info-schema — 一部の TLD では、追加の連絡先情報が必要です。
  • vercel-admin-pp-cli registrar get-domain-auth-code — ドメインの認証コードを取得します。Vercel から別のレジストラへドメインを移管する際に必要です。
  • vercel-admin-pp-cli registrar get-domain-availability — 特定のドメインの利用可否を取得します。
  • vercel-admin-pp-cli registrar get-domain-price — 特定のドメインの価格情報を取得します
  • vercel-admin-pp-cli registrar get-domain-transfer-in — ドメインの移管状況を取得します
  • vercel-admin-pp-cli registrar get-order — ID を指定してドメイン注文の情報を取得します
  • vercel-admin-pp-cli registrar get-supported-tlds — Vercel がサポートする TLD の一覧を取得します
  • vercel-admin-pp-cli registrar get-tld — 特定の TLD のメタデータを取得します。
  • vercel-admin-pp-cli registrar get-tld-price — 特定の TLD の価格情報を取得します。指定した TLD の基本価格のみを反映します。
  • vercel-admin-pp-cli registrar renew-domain — ドメインを更新します
  • vercel-admin-pp-cli registrar transfer-in-domain — 別のレジストラからドメインを移管します
  • vercel-admin-pp-cli registrar update-domain-auto-renew — ドメインの自動更新設定を更新します
  • vercel-admin-pp-cli registrar update-domain-nameservers — ドメインのネームサーバーを更新します。空の配列を渡すと、Vercel のデフォルトのネームサーバーが使用されます。

sandboxes — サンドボックスを管理

  • vercel-admin-pp-cli sandboxes create — 名前付きサンドボックス環境を作成します。
  • vercel-admin-pp-cli sandboxes create-session-directory — セッションのファイルシステムに新しいディレクトリを作成します。
  • vercel-admin-pp-cli sandboxes create-session-snapshot — 実行中のセッションのファイルシステムの特定時点のスナップショットを作成します。
  • vercel-admin-pp-cli sandboxes delete-drive — プロジェクトと名前を指定してドライブを削除します。アタッチされているドライブは削除できません。
  • vercel-admin-pp-cli sandboxes delete-sandbox — 名前を指定してサンドボックスを削除します。サンドボックスが実行中の場合は、先に停止されます。
  • vercel-admin-pp-cli sandboxes delete-session-snapshot — スナップショットを完全に削除し、関連するストレージを解放します。この操作は取り消せません。
  • vercel-admin-pp-cli sandboxes extend-session-timeout — 実行中のセッションの最大実行時間を延長します。セッションはアクティブで、コマンドを受け付けられる状態である必要があります。
  • vercel-admin-pp-cli sandboxes get-named-sandbox — 名前付きサンドボックスを名前で取得します。現在のサンドボックスとルートも含まれます。
  • vercel-admin-pp-cli sandboxes get-or-create-drive — プロジェクトと名前を指定して既存のドライブを取得するか、存在しない場合は作成します。ドライブはプライベートベータ版です。
  • vercel-admin-pp-cli sandboxes get-session — 現在のステータスやリソース設定など、特定のセッションの詳細情報を取得します
  • vercel-admin-pp-cli sandboxes get-session-command — セッションで実行されたコマンドの現在のステータスと詳細を取得します。
  • vercel-admin-pp-cli sandboxes get-session-command-logs — 改行区切りのJSON(ND-JSON)を使用して、コマンドの出力をリアルタイムでストリーミングします。
  • vercel-admin-pp-cli sandboxes get-session-snapshot — 作成日時、サイズ、有効期限など、特定のスナップショットの詳細情報を取得します
  • vercel-admin-pp-cli sandboxes kill-session-command — セッション内で実行中のコマンドを終了するシグナルを送信します。
  • vercel-admin-pp-cli sandboxes list — 特定のプロジェクトに属する名前付きサンドボックスのページネーション付きリストを取得します。
  • vercel-admin-pp-cli sandboxes list-drives — 特定のプロジェクトに属するドライブのページネーション付きリストを取得します。ドライブはプライベートベータ版です。
  • vercel-admin-pp-cli sandboxes list-session-commands — 現在のステータスや終了コードなど、セッションで実行されたすべてのコマンドのリストを取得します
  • vercel-admin-pp-cli sandboxes list-session-snapshots — 特定のプロジェクトのスナップショットのページネーション付きリストを取得します。
  • vercel-admin-pp-cli sandboxes list-sessions — 特定のサンドボックスに属するセッションのページネーション付きリストを取得します。
  • vercel-admin-pp-cli sandboxes read-session-file — セッションのファイルシステムからファイルの内容をダウンロードします。
  • vercel-admin-pp-cli sandboxes run-session-command — 実行中のセッション内でシェルコマンドを実行します。
  • vercel-admin-pp-cli sandboxes stop-session — 実行中のセッションを停止し、割り当てられたリソースを解放します。
  • vercel-admin-pp-cli sandboxes update-sandbox — サンドボックスの設定を更新します。指定されたフィールドのみが変更され、省略されたフィールドは変更されません。
  • vercel-admin-pp-cli sandboxes update-session-network-policy — 実行中のセッションのネットワークアクセスポリシーを置き換えます。
  • vercel-admin-pp-cli sandboxes write-session-files — ファイルをセッションのファイルシステムにアップロードして展開します。ファイルはgzip圧縮されたtarball(`.tar.

セキュリティ — セキュリティを管理します

  • vercel-admin-pp-cli security add-bypass-ip — 新しいシステムバイパスルールを作成します
  • vercel-admin-pp-cli security get-active-attack-status — 過去 N 日間(デフォルト:1 日)のアクティブな攻撃データを取得します
  • vercel-admin-pp-cli security get-bypass-ip — 指定したプロジェクトに設定されているシステムバイパスルールを取得します
  • vercel-admin-pp-cli security get-firewall-config — プロジェクトの指定したファイアウォール設定を取得します。デプロイ済みの configVersion は active になります
  • vercel-admin-pp-cli security get-firewall-events — プロジェクトのファイアウォールアクションを取得します
  • vercel-admin-pp-cli security put-firewall-config — 指定されたルールと設定にファイアウォール設定を変更します。既存のファイアウォール設定がない場合は作成し、ある場合は上書きします
  • vercel-admin-pp-cli security remove-bypass-ip — システムバイパスルールを削除します
  • vercel-admin-pp-cli security update-attack-challenge-mode — プロジェクトで Attack Challenge モードが有効かどうかを判定する設定を更新します
  • vercel-admin-pp-cli security update-firewall-config — プロジェクトの既存のファイアウォール設定を変更する更新を処理します

storage — ストレージを管理

  • vercel-admin-pp-cli storage — 請求プランを自動的に処理して、インテグレーションストアを作成します。

teams — チームを管理

  • vercel-admin-pp-cli teams create — アカウントに新しいチームを作成します。
  • vercel-admin-pp-cli teams delete — アカウントのチームを削除します。削除するチームの id を指定して、DELETE リクエストを送信する必要があります。
  • vercel-admin-pp-cli teams get — 認証済みユーザーがメンバーになっているすべてのチームのページ分割された一覧を取得します。
  • vercel-admin-pp-cli teams get-teamid — teamId パラメーターで指定したチームの情報を取得します。
  • vercel-admin-pp-cli teams patch — teamId パラメーターで指定したチームの情報を更新します。

user — ユーザーを管理

  • vercel-admin-pp-cli user create-auth-token — 現在認証されているユーザーの新しい認証トークンを作成して返します。
  • vercel-admin-pp-cli user delete-auth-token — 認証トークンを無効化し、以後の HTTP リクエストで使用できないようにします。
  • vercel-admin-pp-cli user get-auth — 現在認証されているユーザーに関連する情報を取得します。
  • vercel-admin-pp-cli user get-auth-token — 現在認証されているユーザーの認証トークンに関するメタデータを取得します。
  • vercel-admin-pp-cli user list-auth-tokens — 現在のユーザーの認証トークン一覧を取得します。
  • vercel-admin-pp-cli user request-delete — 削除確認メールを送信し、現在認証されているユーザーの削除手続きを開始します。

webhooks — ウェブフックを管理

  • vercel-admin-pp-cli webhooks create — ウェブフックを作成します
  • vercel-admin-pp-cli webhooks delete — ウェブフックを削除します
  • vercel-admin-pp-cli webhooks get — ウェブフックの一覧を取得します
  • vercel-admin-pp-cli webhooks get-id — ウェブフックを取得します
適切なコマンドを見つける

実行したい操作は分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接尋ねてください。

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

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

認証の設定

vercel-admin-pp-cli auth setup を実行すると、トークンを取得するための URL と手順が表示されます(--launch を追加すると URL を開きます)。次に、トークンを保存します。

vercel-admin-pp-cli auth set-token YOUR_TOKEN_HERE

または、VERCEL_ADMIN_TOKEN を環境変数として設定します。

設定を確認するには、vercel-admin-pp-cli doctor を実行します。

エージェントモード

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

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

  • フィルター可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列では各要素を走査します。出力が冗長な API でコンテキストを小さく保つうえで重要です:

    vercel-admin-pp-cli access-groups list --agent --select id,name,status
    
  • プレビュー可能 — --dry-run で送信せずにリクエストを表示します

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

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

  • 明示的な再試行 — すでに存在するものの作成を成功として扱う場合にのみ --idempotent を使用し、削除対象が存在しない場合に成功として扱う場合にのみ --ignore-missing を使用します

レスポンスエンベロープ

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

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

データには .results を解析し、ライブデータかローカルデータかの判別には .meta.source を参照してください。人が読みやすい N results (live) の概要が stderr に出力されるのは、stdout がターミナルであり、かつ機械可読形式のフラグ(--json、--csv、--compact、--quiet、--plain、--select)が設定されていない場合のみです。パイプ経由/エージェント経由の利用や、形式を明示した実行では、stdout に純粋な JSON が出力されます。

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

この CLI に問題があると気付いた場合は(あなた自身でも、エージェントを通じてでも)、記録してください:

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

エントリーは ~/.local/share/vercel-admin-pp-cli/feedback.jsonl にローカル保存されます。VERCEL_ADMIN_FEEDBACK_ENDPOINT が設定され、かつ --send が渡された場合、または VERCEL_ADMIN_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 ステータスを stderr に記録します。

名前付きプロファイル

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

vercel-admin-pp-cli profile save briefing --json
vercel-admin-pp-cli --profile briefing access-groups list
vercel-admin-pp-cli profile list --json
vercel-admin-pp-cli profile show briefing
vercel-admin-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します:

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

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

  1. MCP サーバーをインストールします:
    go install github.com/mvanhorn/printing-press-library/library/cloud/vercel-admin/cmd/vercel-admin-pp-mcp@latest
    
  2. Claude Code に登録します:
    claude mcp add vercel-admin-pp-mcp -- vercel-admin-pp-mcp
    
  3. 確認します:claude mcp list

直接使用

  1. インストールされているか確認します:which vercel-admin-pp-cli 見つからない場合は、インストールを提案してください(このスキルの冒頭にある「前提条件」を参照)。
  2. ユーザーの問い合わせに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
  3. --agent フラグを付けて実行します:
    vercel-admin-pp-cli <command> [subcommand] [args] --agent
    
  4. あいまいな場合は、サブコマンドのヘルプを確認します:vercel-admin-pp-cli <command> --help。

コメント