mcpField
R
revenuecat-cli

revenuecat-cli

github.com/revenuecat開発76432 回インストール今日更新
リポジトリ

revenuecat-cli について

revenuecat-cliは、プロジェクト、アプリ、製品、エンタイトルメント、オファリング、チャート、ストア状態、ペイウォールを管理するRevenueCat公式のコマンドラインインターフェースです。機械可読な出力と確認可能なコマンドスキーマを備え、ターミナル、CI、エージェントのワークフローに対応します。

主な機能

  1. 01プロジェクト、アプリ、製品カタログの管理
  2. 02チャートと顧客データの確認
  3. 03ペイウォールの生成、編集、公開
  4. 04ペイウォール用メディアとフォントのアップロード
  5. 05JSONでのコマンドとスキーマの確認

活用シーン

  1. 01ターミナルからRevenueCatのリソースを管理
  2. 02CIやエージェントのスクリプトで操作を自動化
  3. 03ペイウォールを編集して素材をアップロード
  4. 04実行前に正確なコマンド引数を確認

MCP 対応

このCLIはRevenueCat MCPサーバーと多くの操作を共有し、ペイウォールの編集やメディア・フォントのアップロードにも対応します。一方、MCPサーバーにはCLIにないSDKの機能ゲートや実験用ツールがあります。

インストール

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

$npx skills add https://github.com/revenuecat/ai-toolkit --skill revenuecat-cli

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

詳細

revenuecat-cli：ターミナルからRevenueCatを操作する

rcは、RevenueCatの公式コマンドラインインターフェイスです。RevenueCat MCP サーバーとほぼ同じプロジェクト、アプリ、製品、エンタイトルメント、オファリング、ペイウォール、チャート、ストア状態の操作に対応しています（CLIにはペイウォールの生成・編集とペイウォール画像・フォントのアップロード機能が追加されています。MCP サーバーには、CLIにないSDK機能のゲート設定や実験用ツールがあります）。利用できる方をお使いください。このスキルでは、CLIを使う方法を説明します。

最初のコマンドを実行する前に

CLIにはシェルが必要です。シェルを利用できない場合（たとえば、MCP サーバーのみを利用できるチャットアプリの場合）は、MCPを使うか、実行すべきrcコマンドまたは使用すべきダッシュボードのページをユーザーに伝えてください。

  1. インストール済みか確認します： rc --version。失敗した場合は、次のいずれかを選択してください。

    • インストールせずに実行する：以下でrcが登場する箇所をすべてnpx @revenuecat/cli <command>に置き換えます。Nodeが必要です。CIやエージェントのサンドボックスに最適です。
    • macOS/Linuxにインストールする：brew install RevenueCat/tap/rc。
    • npmでインストールする：npm install -g @revenuecat/cli。

    インストールするとユーザーのマシンに変更が加わるため、brewまたはnpm install -gを実行する前に許可を求めてください。npxの実行に必要なのは、コマンドの実行許可だけです。

  2. ログイン済みか確認します： rc auth status --json。CLIのログイン状態はMCP サーバーと共有されません。有効な認証情報がない場合は、ユーザー自身でrc auth loginを実行するよう依頼してください。OAuth用のブラウザーが開きます。CIでは、RC_API_KEYを設定するか、--api-keyを渡してください。

  3. プロジェクトを確認します： --project-id <id>を渡すか、ユーザーにrc projects useで既定のプロジェクトを設定してもらいます。

CLIの認証にはRevenueCatのシークレットキー（sk_...）を使います。CLIはサーバー側のツールなので、これで正しい方法です。クライアントアプリのコード用に取得する公開SDKキー（appl_/goog_/amzn_）とは異なります。アプリにシークレットキーを含めないでください。また、チャットにキーを貼り付けるようユーザーに求めないでください。

CLIで利用できる機能を調べる

CLIは自己記述型です。コマンドやフラグを推測せず、バイナリに確認してください。

  • rc commands --jsonは、コマンドツリー全体を一覧表示します。機能IDはコロン形式で表示されます（apps:create、products:store:plan）。
  • rc commands --schemas --jsonは、すべてのコマンドのフラグ、引数、使用例を1回の呼び出しで返します。エージェントがコマンドごとの詳細を調べるうえで、最も確実な方法です。
  • rc schema <command> --jsonは、単一のコマンドの詳細を返します。ただし、コマンドはrc commandsのコロン形式ではなく、スペースで区切ったトークンで指定する必要があります（rc schema apps create）。rc schema apps:createを実行すると、エラーなくルートスキーマが返されます。迷った場合はrc commands --schemasを使ってください。
  • rc --helpとrc <noun> --helpは、人が読みやすい形式でヘルプを表示します。

出力の規則

  • --jsonを指定すると、安定した機械可読形式で出力されます。データはstdoutに、進行状況やその他のメッセージはstderrに出力されます。
  • エンベロープは{ "data": ... }ですが、dataの下の構造はコマンドによって異なります。一覧では通常data.items[]が使われますが、別のキーを使うコマンドもあります（チャートではdata.names[]）。data.itemsと決めつけず、スキーマまたはレスポンスを確認してください。
  • --no-inputはプロンプトを表示せず、代わりにエラーになります。スクリプト、CI、エージェントで使ってください。
  • --yes / -yは、データを変更するコマンドで確認プロンプトをスキップします。
  • --project-id <id>はプロジェクトを選択します（またはrc projects useで既定のプロジェクトを設定できます）。スクリプトでは明示的に渡してください。
  • 終了コード：0は成功、1はエラー、2は使用方法の誤り、4は認証エラー、5は見つからない、6はレート制限です。

よく使う操作

正確なフラグは、rc commands --schemas --json（または rc schema <space-separated command>）で確認します。よく使う名詞は次のとおりです。

  • プロジェクトとアプリ：rc projects list|create|use、rc apps list|create|keys
  • カタログ：rc products ...、rc entitlements ...、rc offerings ...、rc packages ...
  • ストアの認証情報と状態：rc setup apple|google、rc products store plan|apply|sync
  • データ：rc charts list|show、rc customers ...
  • ペイウォール：rc paywalls generate|edit|publish（ダッシュボードでのデザイン／監査用プレイブック：revenuecat-paywall-design）
  • ペイウォールのメディアとフォント：rc media-assets list|upload <file>、rc fonts list|upload <file>。MCP ではこれらをアップロードできません。ブラウザーでダッシュボードを使用しないでください。
  • ダッシュボード：rc open [section] [id] --print（リソース URL：revenuecat-dashboard-links）

画像：jpg/png/webp/avif/heic/heif、最大 2 MiB。フォント：ttf/otf、最大 5 MiB。まずファイルをディスク上に作成または生成してから、そのパスを渡してください。フラグは rc schema media-assets upload／rc schema fonts upload で確認します。

該当するコマンドを優先してください。CLI でまだ利用できないエンドポイントに限り、rc api <METHOD> <path> を使用します。

コメント

Markdown 対応