コンテンツにスキップ
Game Market Copilot Docs
日本語
English日本語
Esc
↑↓navigate↵open⌘Jpreview
このページの内容

CLI

Game Market CopilotのCLIクライアントgmcのインストール、認証、スクリプトからの利用方法です。

Claude CodeやCodexのようなAIエージェントを接続する場合は、CLIではなく GMC MCPから始めることを推奨します。CLIは、シェル中心のワ ークフロー、スクリプト、CIに向いたツールです。

インストール

CLIはnpmパッケージ@witchpot/gmcとして配布されており、Node.js 20以降が必 要です。

npm install -g @witchpot/gmc@latest

リリースはデフォルトのlatest dist-tagで配布されます。

このパッケージはgmc、gmcp、game-market-copilotという3つの同等のバイ ナリをインストールします。一部のシェル設定(例えばOh My Zshのgitプラグイン) ではgmcをgitコマンドのエイリアスにしています。お使いのシェルでgmcがCLI として動作しない場合は、すべての呼び出しで代わりにgmcpを使ってください。 まったく同じツールです。

ログイン

gmc login

これにより、PKCEとループバックコールバックを使ったOAuthフローがブラウザで 開きます。成功すると、CLIはCLI認証情報を~/.config/gmc/config.json(作成時 のパーミッションは0600)に保存します。ローカル開発ではこの方法を推奨しま す。

代わりに長期利用のAPIキー(GMCダッシュボードの設定 → API・連携で作成)を使う 場合は、ブラウザフローを省略できます。

gmc login --api-key gmc_...

現在有効な認証情報を確認します。

gmc auth status --json

ログアウト(保存済みのCLI認証情報を失効させ、ローカル設定から削除します。 APIキーには影響せず、設定で失効させるまで有効なままです)。

gmc logout

APIキー・CLI認証情報・MCPトークンの違いについては /api/overviewを参照してください。

設定

gmc config get
gmc config set apiBaseUrl <url>

設定はデフォルトで~/.config/gmc/config.jsonから読み込まれます。環境変数 は設定ファイルより優先され、CIではこちらの利用を推奨します。

変数 用途
GMC_API_KEY ワークスペースのAPIキー。ベアラートークンとして送信されます。
GMC_CLI_CREDENTIAL gmc loginで取得したCLI認証情報。ベアラートークンとして送信されます。
GMC_API_BASE_URL APIのベースURLを上書きします(デフォルトはhttps://gamemarketcopilot.com)。
GMC_CONFIG_PATH 設定ファイルのパスを上書きします。

出力の整形

データを扱うすべてのコマンドは--jsonによる構造化出力に対応しており、スク リプトやエージェントのワークフローではこちらを使ってください(gmc skill print は例外で、フラグの指定にかかわらず生のMarkdownを出力します)。ほとんどの読 み取りコマンドは次のオプションにも対応しています。

  • --fields <list>: 指定したフィールドのみをカンマ区切りで返します。
  • --preset <name>: 対応している場合、名前付きの出力形式を適用します。

終了コード

コード 内容
1 想定外のエラー。
2 使い方のエラー(引数が不正)。
3 設定が存在しない、または不正。
4 APIエラー(リクエストはサーバーに到達したが、エラーが返された)。

コマンド分類

コマンドとパラメーターの正本かつ機械可読な一覧はgmc schema --jsonで取得 できます。このページではコマンドの完全なリファレンスではなく分類のみを扱 っています。スキーマの出力はAPIと同じ契約から生成されており、常に最新の状 態が保たれるためです。

  • ステータスと機能確認: gmc status、gmc auth status、gmc schema、 gmc tags。
  • ゲーム: gmc games search、count、aggregate、resolve、detail、 analysis、success-report、compare、topics、benchmark。
  • リスト: gmc listsと、リストの作成・ゲーム管理のためのサブコマンド。
  • コホート分析: gmc cohort trends、pricing、compare、brief。
  • ショーケース: gmc showcases search、fit、patterns。
  • レビュー・マーケティング・クリエイター・キャンペーン: gmc reviews patterns、gmc marketing patterns、gmc marketing timing、 gmc creators patterns、gmc campaigns signalsのようなパターン・シグナ ル系コマンド。

--tagsフィルターを受け付けるコマンドは、未知のスラッグを指定すると400の INVALID_TAGエラーと候補の一覧を返します。フィルターを組み立てる前に、まず gmc tags --q <term>を実行してジャンルやキーワードを有効なスラッグに解決し てください。

アップデート

gmc update

これは自動でアップデートするのではなく、手動アップデートの手順(現在のバー ジョンと、実行すべきnpm install/npxコマンド)を表示します。アップデート するには、このページ冒頭のインストールコマンドを再度実行してください。

関連ページ

  • /api/overview: 認証方式、レスポンスエンベロープ、エラ ー、クレジット・レート制限の挙動について。CLIは同じAPIの薄いクライアント であり、これらすべてを引き継いでいます。
  • /api/endpoints: CLIコマンドが対応するエンドポイント 分類について。
  • /agents/mcp: CLIの代わりにMCP経由でエージェントからアク セスする方法について。

このページは役に立ちましたか？