pp-amazon-seller

Amazon Seller — Printing Press CLI

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

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

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

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

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

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

go install github.com/mvanhorn/printing-press-library/library/commerce/amazon-seller/cmd/amazon-seller-pp-cli@latest

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

コマンドリファレンス

catalog — Catalog Items API の商品データを読み取ります。

• amazon-seller-pp-cli catalog get — ASIN を指定してカタログ商品を 1 件取得します。
• amazon-seller-pp-cli catalog search — カタログ商品を検索します。marketplaceIds と、keywords や identifiers などの有効な検索モードを 1 つ指定します...

fba-inventory — Fulfillment by Amazon の在庫サマリーを確認します。

• amazon-seller-pp-cli fba-inventory — FBA 在庫サマリーを一覧表示します。北米のマーケットプレイス単位の在庫を取得するには、granularityType=Marketplace を渡します...

listings — Listings Items API の出品者 SKU データを読み取ります。

• amazon-seller-pp-cli listings get — 出品者 ID と SKU を指定して、出品商品を 1 件取得します。
• amazon-seller-pp-cli listings search — 出品者の商品を検索します。

orders — Orders API v2026-01-01 の注文レコードを検索して確認します。

• amazon-seller-pp-cli orders get — Orders API v2026-01-01 の注文を 1 件取得します。
• amazon-seller-pp-cli orders search — 注文を検索します。createdAfter または lastUpdatedAfter のどちらか一方だけを指定してください。組み合わせが無効な場合、Amazon は 400 を返します。

reports — レポートを作成し、レポートのステータスをポーリングして、レポートドキュメントのメタデータを確認します。

• amazon-seller-pp-cli reports create — レポートリクエストを作成します。marketplaceIds を JSON 配列として保持し、reportOptions... を指定するため、JSON ボディには --stdin を使用してください。
• amazon-seller-pp-cli reports document — レポートドキュメントのメタデータと、署名付きダウンロード URL を取得します。このコマンドはドキュメントをダウンロードしたり開いたりしません。
• amazon-seller-pp-cli reports get — レポート ID を指定して、レポートを 1 件取得します。レポート処理ステータスを手動でポーリングするエンドポイントです。
• amazon-seller-pp-cli reports list — レポートを一覧表示します。nextToken が設定されている場合、Amazon はそれを唯一のクエリパラメーターとして指定するよう要求します。ほかのフィルターは指定しないでください...

inbound-plans — Fulfillment Inbound v2024-03-20 の納品プランを作成、管理します。

• amazon-seller-pp-cli inbound-plans create --marketplace-id ATVPDKIKX0DER --source-address address.json --items items.csv --name "June FBA" — CSV/JSON 入力から createInboundPlan のリクエストボディをプレビューします。書き込みコマンド: 送信するには --yes を、HTTP リクエストをレンダリングするには --dry-run を、返されたオペレーションをポーリングするには --wait を指定します。
• amazon-seller-pp-cli inbound-plans create --stdin — stdin から Amazon の正確な createInboundPlan JSON リクエストボディを読み取ります。書き込みコマンド: 送信するには --yes を指定します。
• amazon-seller-pp-cli inbound-plans status --operation-id <operationId> --wait — 非同期の Fulfillment Inbound POST/PUT オペレーションに対して getInboundOperationStatus をポーリングします。
• amazon-seller-pp-cli inbound-plans get <inboundPlanId> — 1 つのインバウンドプランを取得します。
• amazon-seller-pp-cli inbound-plans list --status ACTIVE --page-size 10 — インバウンドプランを一覧表示します。
• amazon-seller-pp-cli inbound-plans cancel <inboundPlanId> --yes — インバウンドプランをキャンセルします。書き込みコマンド: --dry-run が設定されていない限り --yes が必要です。
• amazon-seller-pp-cli inbound-plans packing generate --inbound-plan-id <id> — 梱包オプションを生成します。書き込みコマンド: リクエストのプレビューには --dry-run を使用します。
• amazon-seller-pp-cli inbound-plans packing list --inbound-plan-id <id> — 梱包オプションを一覧表示します。
• amazon-seller-pp-cli inbound-plans packing confirm --inbound-plan-id <id> --option-id <packingOptionId> --yes — 梱包オプションを確定します。書き込みコマンド: --dry-run が設定されていない限り --yes が必要です。
• amazon-seller-pp-cli inbound-plans packing set --inbound-plan-id <id> --body cartons.json --yes — カートン単位の梱包情報を設定します。書き込みコマンド: --dry-run が設定されていない限り --yes が必要です。
• amazon-seller-pp-cli inbound-plans placement generate --inbound-plan-id <id> --body placement.json — 配置オプションを生成します。必要に応じて customPlacement JSON を指定できます。書き込みコマンド: プレビューではなく送信するボディを指定する場合は --yes を渡します。
• amazon-seller-pp-cli inbound-plans placement list --inbound-plan-id <id> — 配置オプションを一覧表示します。
• amazon-seller-pp-cli inbound-plans placement confirm --inbound-plan-id <id> --option-id <placementOptionId> --yes — 配置オプションを確定します。書き込みコマンド: --dry-run が設定されていない限り --yes が必要です。
• amazon-seller-pp-cli inbound-plans transportation generate --inbound-plan-id <id> --body transportation.json — 配置/出荷 JSON から輸送オプションを生成します。書き込みコマンド: プレビューではなく送信するボディを指定する場合は --yes を渡します。
• amazon-seller-pp-cli inbound-plans transportation list --inbound-plan-id <id> --placement-option-id <placementOptionId> — 輸送オプションを一覧表示します。
• amazon-seller-pp-cli inbound-plans transportation confirm --inbound-plan-id <id> --body selections.json --yes — 輸送の選択を確定します。書き込みコマンド: --dry-run が設定されていない限り --yes が必要です。

CSV の item 入力には、msku,quantity,prepOwner,labelOwner,expiration,manufacturingLotCode の列を使用します。米国マーケットプレイス ATVPDKIKX0DER では、prepOwner=AMAZON または labelOwner=AMAZON の場合に CLI が警告を表示します。これは、Amazon が米国 FBA の prep および item label サービスを 2026 年 1 月 1 日から提供しないとしているためです。

profitability — Amazon のレポートから推定 SKU 収益性を計算します。

• amazon-seller-pp-cli profitability sku-pnl --marketplace-id ATVPDKIKX0DER --days 30 — SKU ごとの売上、手数料、保管コスト、マージン、利益を推定します。

• amazon-seller-pp-cli profitability fee-breakdown --marketplace-id ATVPDKIKX0DER — 推定紹介手数料、FBA 手数料、クロージング手数料、および合計手数料の割合を項目別に表示します。

• amazon-seller-pp-cli profitability settlement-reconciliation --marketplace-id ATVPDKIKX0DER --days 90 — 注文の売上を完了した精算行と比較し、不一致をフラグ付けします。

• amazon-seller-pp-cli profitability reimbursements --marketplace-id ATVPDKIKX0DER --days 90 — 返金を SKU および理由ごとに集計します。 inventory-intel — FBA 在庫の健全性、補充、滞留期間、フルフィルメントに関する推奨事項を算出します。

• amazon-seller-pp-cli inventory-intel health-score --marketplace-id ATVPDKIKX0DER — SKU ごとに在庫の健全性をスコア化します。

• amazon-seller-pp-cli inventory-intel restock --marketplace-id ATVPDKIKX0DER --lead-time-days 14 — 欠品時期と再発注数量を推定します。

• amazon-seller-pp-cli inventory-intel stranded --marketplace-id ATVPDKIKX0DER — 余剰在庫の行と推奨アクションを表示します。

• amazon-seller-pp-cli inventory-intel aging --marketplace-id ATVPDKIKX0DER --warn-days 150 — 長期保管手数料のリスクを予測します。

• amazon-seller-pp-cli inventory-intel fba-vs-fbm --marketplace-id ATVPDKIKX0DER --estimated-shipping-cost 5 — FBA と FBM のユニットあたり推定利益を比較します。

sales-intel — 売上、トラフィック、コンバージョン、販売速度、返品の分析を算出します。

• amazon-seller-pp-cli sales-intel dashboard --marketplace-id ATVPDKIKX0DER --days 30 --group-by date — 売上・トラフィックレポートの指標を集計します。
• amazon-seller-pp-cli sales-intel velocity --marketplace-id ATVPDKIKX0DER --days 60 — SKU の販売速度の傾向と異常を検出します。
• amazon-seller-pp-cli sales-intel returns --marketplace-id ATVPDKIKX0DER --days 30 — 返品率、返品理由、顧客コメントを分析します。
• amazon-seller-pp-cli sales-intel conversion-funnel --marketplace-id ATVPDKIKX0DER --days 30 — トラフィック、カートボックス、コンバージョンのボトルネックを診断します。

brand-analytics — Brand Registry の検索語句と併売に関するインサイトを算出します。

• amazon-seller-pp-cli brand-analytics search-terms --marketplace-id ATVPDKIKX0DER --period WEEK — 追跡対象の ASIN がクリック上位に表示される検索語句を表示します。
• amazon-seller-pp-cli brand-analytics market-basket --marketplace-id ATVPDKIKX0DER --period WEEK — お使いの ASIN と一緒に購入されることの多い商品を表示します。

listing-intel — レポートとローカルの出品データをもとに、出品情報の不備と完全性を監査します。

• amazon-seller-pp-cli listing-intel health-audit --marketplace-id ATVPDKIKX0DER — 出品情報の不備に関するアラートと抑制の兆候を集計します。
• amazon-seller-pp-cli listing-intel catalog-completeness --marketplace-id ATVPDKIKX0DER --seller-id <seller> — ローカルの出品情報レコードをもとに、画像、箇条書き、タイトル、A+ コンテンツの完全性をスコア化します。

account-health — アカウント全体の出品情報、在庫、返品、返金の健全性を集計します。

• amazon-seller-pp-cli account-health dashboard --marketplace-id ATVPDKIKX0DER — 出品停止中の出品情報、余剰在庫数、返品率、返金、不備の件数、在庫評価の概要をまとめたダッシュボードを作成します。

sellers — 出品者の認証を確認し、マーケットプレイスへの参加状況を一覧表示します。

• amazon-seller-pp-cli sellers — 認証済み出品者アカウントのマーケットプレイスへの参加状況を一覧表示します。

適切なコマンドを探す

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

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

which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は一致する項目が 1 つ以上あることを示します。終了コード 2 は確実な一致がないことを示します。その場合は --help を使うか、より範囲を絞った問い合わせを行ってください。

認証の設定

プロバイダーコンソールでプライベートアプリを自分で認証し、OAuth クライアント ID、OAuth クライアントシークレット、リフレッシュトークンを環境変数に設定してから、doctor を実行します。

export SP_API_LWA_CLIENT_ID="<client-id>"
export SP_API_LWA_CLIENT_SECRET="<client-secret>"
export SP_API_REFRESH_TOKEN="<refresh-token>"
amazon-seller-pp-cli doctor

CLI は初回のライブ使用時にリフレッシュトークンをアクセストークンと交換し、アクセストークンをローカルにキャッシュします。

amazon-seller-pp-cli doctor を実行して設定を確認してください。

エージェントモード

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

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

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

  amazon-seller-pp-cli catalog get <asin> --marketplace-ids ATVPDKIKX0DER --agent --select asin,attributes,summaries
  

• プレビュー可能 — --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 について気になる点に気づいた場合は（エージェントが気づいた場合も同様に）、記録してください：

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

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

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で記録してください。積み重ねにつながるのはそこです。

出力の送信先

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

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

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

名前付きプロファイル

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

amazon-seller-pp-cli profile save briefing --json
amazon-seller-pp-cli --profile briefing sellers marketplaces
amazon-seller-pp-cli profile list --json
amazon-seller-pp-cli profile show briefing
amazon-seller-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します：

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

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

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

   go install github.com/mvanhorn/printing-press-library/library/commerce/amazon-seller/cmd/amazon-seller-pp-mcp@latest
   

2. Claude Code に登録します：

   claude mcp add amazon-seller-pp-mcp -- amazon-seller-pp-mcp
   

3. 確認します：claude mcp list

直接利用

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

   amazon-seller-pp-cli <command> [subcommand] [args] --agent
   

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