pp-midjourney

Midjourney — Printing Press CLI

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

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

1. Printing Press インストーラーを使ってインストールします。macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin がバイナリの既定のインストール先です。

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

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

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

go install github.com/mvanhorn/printing-press-library/library/ai/midjourney/cmd/midjourney-pp-cli@latest

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

この CLI を使用しない場合

生成されたエンドポイントコマンドの大半は、読み取り専用の確認コマンドです。ユーザーから Midjourney の作業を送信するよう明示的に依頼されない限り、変更を伴うコマンドは使用しないでください。特に、imagine と rerun は Midjourney のリモートジョブを作成し、download はローカルファイルを書き込みます。

HTTP トランスポート

この CLI は、ブラウザー向けエンドポイントに Chrome 互換の HTTP トランスポートを使用します。通常の API 呼び出しに、常駐するブラウザープロセスは必要ありません。

検出シグナル

この CLI は、ブラウザーで観測されたトラフィックのコンテキストを使って生成されました。

• キャプチャ範囲：全ネットワークエントリ 62 件中、API エントリ 62 件
• プロトコル：rest_json（信頼度 75%）
• 生成ヒント：browser_http_transport、requires_protected_client
• コマンド候補の案：list_contests_ranking_count — GET /api/contests-ranking-count のトラフィックから導出。list_editor_sessions_sync — GET /api/editor-sessions-sync のトラフィックから導出。list_explore — GET /api/explore のトラフィックから導出。list_explore_styles_likes — GET /api/explore-styles-likes のトラフィックから導出。list_folders — GET /api/folders のトラフィックから導出。list_following_for_user — GET /api/following-for-user のトラフィックから導出。list_get_user_country — GET /api/get-user-country のトラフィックから導出。list_imagine — GET /api/imagine のトラフィックから導出。

コマンドリファレンス

explore — Midjourney の Explore フィードを閲覧します

• midjourney-pp-cli explore list — Explore フィードを取得します
• midjourney-pp-cli explore style-likes — Explore カードのスタイル「いいね」メタデータを取得します

folders — Midjourney の整理フォルダーを確認します

• midjourney-pp-cli folders — 認証済みアカウントのフォルダーを一覧表示します

generations — 生成された Midjourney ジョブと画像履歴を確認します

• midjourney-pp-cli generations list — 認証済み Midjourney ユーザーの最近のジョブ／画像を一覧表示します
• midjourney-pp-cli generations updates — 認証済みユーザーの最近のジョブ更新をポーリングします

moodboards — Midjourney のムードボードを確認します

• midjourney-pp-cli moodboards — 認証済みアカウントのムードボードを一覧表示します

profiles — パーソナライズ／プロフィールのメタデータを確認します

• midjourney-pp-cli profiles following — ログイン中のユーザーのフォロー情報を一覧表示します
• midjourney-pp-cli profiles personalized — パーソナライズされたプロフィールのメタデータを一覧表示します

queue — 現在の Midjourney 生成キューを確認します

• midjourney-pp-cli queue — ログイン中のアカウントのキュー内／実行中の Midjourney の作業を表示します

rankings — ランキングと評価の画面を確認します

• midjourney-pp-cli rankings contests-count — コンテストのランキング件数を取得します
• midjourney-pp-cli rankings model-ratings — アカウントに表示されるモデル評価タスクを取得します

storage — Midjourney アカウントのストレージメタデータを確認します

• midjourney-pp-cli storage — Web アプリが公開するストレージメタデータを一覧表示します

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

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

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

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

認証のセットアップ

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

export MIDJOURNEY_COOKIE_HEADER="<your-key>"

または、`` に保存します。

midjourney-pp-cli doctor を実行して、セットアップを確認してください。

エージェントモード

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

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

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

  midjourney-pp-cli explore list --agent --select id,name,status
  

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

• オフラインに対応 — sync/search コマンドは、利用可能な場合、ローカルの 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 に問題があることに気づいたら、記録してください。

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

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

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

出力の配信

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

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

未対応のスキームは、対応しているスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードが返され、URL と HTTP ステータスが stderr に記録されます。

名前付きプロファイル

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

midjourney-pp-cli profile save briefing --json
midjourney-pp-cli --profile briefing explore list
midjourney-pp-cli profile list --json
midjourney-pp-cli profile show briefing
midjourney-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/ai/midjourney/cmd/midjourney-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add midjourney-pp-mcp -- midjourney-pp-mcp
   

3. 確認します：claude mcp list

直接使用

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

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

4. 不明な点がある場合は、サブコマンドのヘルプを確認します：midjourney-pp-cli <command> --help。