Back to Details

pp-amazon-seller

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Amazon Seller — Printing Press CLI

亚马逊卖家 — Printing Press CLI

Prerequisites: Install the CLI

前提条件：安装CLI

This skill drives the 
amazon-seller-pp-cli
binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
  1. Install via the Printing Press installer:
    bash
    npx -y @mvanhorn/printing-press install amazon-seller --cli-only
  2. Verify: 
    amazon-seller-pp-cli --version
  3. Ensure 
    $GOPATH/bin
    (or 
    $HOME/go/bin
    ) is on 
    $PATH
    .
If the 
npx
install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.23+):
bash
go install github.com/mvanhorn/printing-press-library/library/commerce/amazon-seller/cmd/amazon-seller-pp-cli@latest
If 
--version
reports "command not found" after install, the install step did not put the binary on 
$PATH
. Do not proceed with skill commands until verification succeeds.
本Skill驱动
amazon-seller-pp-cli
二进制文件。**在调用本Skill的任何命令之前，您必须确认CLI已安装。**如果未安装，请先执行以下步骤安装：
  1. 通过Printing Press安装程序安装：
    bash
    npx -y @mvanhorn/printing-press install amazon-seller --cli-only
  2. 验证：
    amazon-seller-pp-cli --version
  3. 确保
    $GOPATH/bin
    （或
    $HOME/go/bin
    ）已添加到
    $PATH
    环境变量中。
如果
npx
安装失败（如无Node环境、离线等），可改用Go直接安装（要求Go 1.23及以上版本）：
bash
go install github.com/mvanhorn/printing-press-library/library/commerce/amazon-seller/cmd/amazon-seller-pp-cli@latest
如果安装后执行
--version
提示“command not found”，说明安装步骤未将二进制文件添加到
$PATH
中。请在验证成功前不要执行Skill命令。

Command Reference

命令参考

catalog — Read Catalog Items API item data.
  • amazon-seller-pp-cli catalog get
    — Get one catalog item by ASIN.
  • amazon-seller-pp-cli catalog search
    — Search catalog items. Provide marketplaceIds plus one valid search mode such as keywords or identifiers with...
fba-inventory — Inspect Fulfillment by Amazon inventory summaries.
  • amazon-seller-pp-cli fba-inventory
    — List FBA inventory summaries. For North America marketplace-level inventory, pass granularityType=Marketplace,...
listings — Read Listings Items API data for seller SKUs.
  • amazon-seller-pp-cli listings get
    — Get one listing item by seller ID and SKU.
  • amazon-seller-pp-cli listings search
    — Search listing items for a seller.
orders — Search and inspect Orders API v2026-01-01 order records.
  • amazon-seller-pp-cli orders get
    — Get one Orders API v2026-01-01 order.
  • amazon-seller-pp-cli orders search
    — Search orders. Provide exactly one of createdAfter or lastUpdatedAfter; Amazon returns 400 for invalid combinations.
reports — Create reports, poll report status, and inspect report document metadata.
  • amazon-seller-pp-cli reports create
    — Create a report request. Prefer --stdin for JSON bodies so marketplaceIds remains a JSON array and reportOptions...
  • amazon-seller-pp-cli reports document
    — Get report document metadata and the presigned download URL. This command does not download or open the document.
  • amazon-seller-pp-cli reports get
    — Get one report by report ID. This is the manual polling endpoint for report processing status.
  • amazon-seller-pp-cli reports list
    — List reports. If nextToken is set, Amazon requires it to be the only query parameter; pass no other filters with...
sellers — Verify seller authorization and list marketplace participations.
  • amazon-seller-pp-cli sellers
    — List marketplace participations for the authorized seller account.
catalog — 读取商品目录Items API的商品数据。
  • amazon-seller-pp-cli catalog get
    — 通过ASIN获取单个商品目录项。
  • amazon-seller-pp-cli catalog search
    — 搜索商品目录项。需提供marketplaceIds以及一种有效的搜索模式，如关键词或标识符...
fba-inventory — 查看亚马逊物流（FBA）库存汇总。
  • amazon-seller-pp-cli fba-inventory
    — 列出FBA库存汇总。如需查看北美地区市场级库存，请传入granularityType=Marketplace...
listings — 读取卖家SKU的Listings Items API数据。
  • amazon-seller-pp-cli listings get
    — 通过卖家ID和SKU获取单个商品listing项。
  • amazon-seller-pp-cli listings search
    — 搜索卖家的商品listing项。
orders — 搜索并查看Orders API v2026-01-01的订单记录。
  • amazon-seller-pp-cli orders get
    — 获取单个Orders API v2026-01-01订单。
  • amazon-seller-pp-cli orders search
    — 搜索订单。必须提供createdAfter或lastUpdatedAfter中的一个；若组合无效，亚马逊会返回400错误。
reports — 创建报告、轮询报告状态并查看报告文档元数据。
  • amazon-seller-pp-cli reports create
    — 创建报告请求。建议通过--stdin传入JSON请求体，确保marketplaceIds保持为JSON数组且reportOptions...
  • amazon-seller-pp-cli reports document
    — 获取报告文档元数据和预签名下载链接。此命令不会下载或打开文档。
  • amazon-seller-pp-cli reports get
    — 通过报告ID获取单个报告。这是手动轮询报告处理状态的端点。
  • amazon-seller-pp-cli reports list
    — 列出报告。如果设置了nextToken，亚马逊要求它是唯一的查询参数；请勿同时传入其他筛选条件...
sellers — 验证卖家授权并列出参与的市场。
  • amazon-seller-pp-cli sellers
    — 列出已授权卖家账户参与的市场。

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
amazon-seller-pp-cli which "<capability in your own words>"
which
resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 
0
means at least one match; exit code 
2
means no confident match — fall back to 
--help
or use a narrower query.
当您知道要执行的操作但不确定对应命令时，可直接询问CLI：
bash
amazon-seller-pp-cli which "<用您自己的话描述功能>"
which
命令会将自然语言的功能查询解析为与CLI精选功能索引最匹配的命令。退出码
0
表示至少有一个匹配项；退出码
2
表示没有确定的匹配项——此时可改用
--help
或缩小查询范围。

Auth Setup

授权设置

Self-authorize your private application in the provider console, export the OAuth client ID, OAuth client secret, and refresh token, then run doctor:
bash
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
The CLI exchanges the refresh token for an access token on first live use and caches the access token locally.
Run 
amazon-seller-pp-cli doctor
to verify setup.
在服务商控制台中为您的私有应用完成自授权，导出OAuth客户端ID、OAuth客户端密钥和刷新令牌，然后运行doctor命令：
bash
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 Mode

Agent模式

Add 
--agent
to any command. Expands to: 
--json --compact --no-input --no-color --yes
.
  • Pipeable — JSON on stdout, errors on stderr
  • Filterable — 
    --select
    keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
    bash
    amazon-seller-pp-cli catalog get <asin> --marketplace-ids ATVPDKIKX0DER --agent --select asin,attributes,summaries
  • Previewable — 
    --dry-run
    shows the request without sending
  • Offline-friendly — sync/search commands can use the local SQLite store when available
  • Non-interactive — never prompts, every input is a flag
  • Explicit retries — use 
    --idempotent
    only when an already-existing create should count as success
在任何命令后添加
--agent
参数，等效于：
--json --compact --no-input --no-color --yes
。
  • 可管道传输 — 标准输出为JSON格式，错误信息输出到标准错误流
  • 可筛选 — 
    --select
    参数保留字段子集。点路径可深入嵌套结构；数组会遍历每个元素。对于输出冗长的API，此功能对缩小上下文范围至关重要：
    bash
    amazon-seller-pp-cli catalog get <asin> --marketplace-ids ATVPDKIKX0DER --agent --select asin,attributes,summaries
  • 可预览 — 
    --dry-run
    参数会显示请求内容但不发送
  • 离线友好 — 同步/搜索命令在本地SQLite存储可用时可使用该存储
  • 非交互式 — 从不弹出提示，所有输入均通过参数传递
  • 显式重试 — 仅当已存在的创建操作应视为成功时，才使用
    --idempotent
    参数

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
Parse 
.results
for data and 
.meta.source
to know whether it's live or local. A human-readable 
N results (live)
summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.
从本地存储或API读取数据的命令会将输出包装在来源信封中：
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
解析
.results
字段获取数据，通过
.meta.source
字段判断数据来自实时API还是本地存储。仅当标准输出为终端时，才会在标准错误流中打印人类可读的
N results (live)
摘要；管道传输/Agent消费者只会在标准输出中获取纯JSON内容。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:
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
Entries are stored locally at 
~/.amazon-seller-pp-cli/feedback.jsonl
. They are never POSTed unless 
AMAZON_SELLER_FEEDBACK_ENDPOINT
is set AND either 
--send
is passed or 
AMAZON_SELLER_FEEDBACK_AUTO_SEND=true
. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当您（或Agent）发现此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发送。默认行为仅存储在本地。
请写下让您感到意外的点，而非正式的Bug报告。简短、具体、单条描述：这样的反馈才更有价值。

Output Delivery

输出交付

Every command accepts 
--deliver <sink>
. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
SinkEffect
stdout
Default; write to stdout only
file:<path>
Atomically write output to 
<path>
(tmp + rename)
webhook:<url>
POST the output body to the URL (
application/json
or 
application/x-ndjson
when 
--compact
)
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
每个命令都支持
--deliver <sink>
参数。输出会除了（或代替）标准输出外发送到指定的输出目标，以便Agent无需手动管道即可路由命令结果。支持三种输出目标：
输出目标效果
stdout
默认值；仅输出到标准输出
file:<path>
原子性地将输出写入
<path>
（先写入临时文件再重命名）
webhook:<url>
将输出内容POST到指定URL（使用
--compact
时为
application/json
或
application/x-ndjson
格式）
未知的协议会被拒绝，并返回包含支持协议列表的结构化错误。Webhook失败会返回非零退出码，并在标准错误流中记录URL和HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
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
Explicit flags always win over profile values; profile values win over defaults. 
agent-context
lists all available profiles under 
available_profiles
so introspecting agents discover them at runtime.
配置文件是一组保存的参数值，可在多次调用中复用。当定时Agent每次运行都使用相同配置调用同一命令时，可使用此功能——即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
下列出所有可用配置文件，以便自省Agent在运行时发现它们。

Exit Codes

退出码

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
4Authentication required
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error
代码含义
0成功
2使用错误（参数错误）
3资源未找到
4需要身份验证
5API错误（上游问题）
7请求受限（请等待后重试）
10配置错误

Argument Parsing

参数解析

Parse 
$ARGUMENTS
:
  1. Empty, 
    help
    , or 
    --help
     → show 
    amazon-seller-pp-cli --help
    output
  2. Starts with 
    install
     → ends with 
    mcp
    → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with 
    --agent
    )
解析
$ARGUMENTS
：
  1. 为空、
    help
    或
    --help
     → 显示
    amazon-seller-pp-cli --help
    的输出内容
  2. 以
    install
    开头     → 若以
    mcp
    结尾 → 执行MCP安装；否则 → 参考上方的前提条件部分
  3. 其他情况 → 直接使用（以
    --agent
    参数执行CLI命令）

MCP Server Installation

MCP服务器安装

  1. Install the MCP server:
    bash
    go install github.com/mvanhorn/printing-press-library/library/commerce/amazon-seller/cmd/amazon-seller-pp-mcp@latest
  2. Register with Claude Code:
    bash
    claude mcp add amazon-seller-pp-mcp -- amazon-seller-pp-mcp
  3. Verify: 
    claude mcp list
  1. 安装MCP服务器：
    bash
    go install github.com/mvanhorn/printing-press-library/library/commerce/amazon-seller/cmd/amazon-seller-pp-mcp@latest
  2. 在Claude Code中注册：
    bash
    claude mcp add amazon-seller-pp-mcp -- amazon-seller-pp-mcp
  3. 验证：
    claude mcp list

Direct Use

直接使用

  1. Check if installed: 
    which amazon-seller-pp-cli
    If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the 
    --agent
    flag:
    bash
    amazon-seller-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help: 
    amazon-seller-pp-cli <command> --help
    .
  1. 检查是否已安装：
    which amazon-seller-pp-cli
    如果未找到，可提供安装选项（参见顶部前提条件部分）。
  2. 将用户查询与上方“独特功能”和“命令参考”中的最佳匹配命令对应起来。
  3. 使用
    --agent
    参数执行命令：
    bash
    amazon-seller-pp-cli <command> [subcommand] [args] --agent
  4. 如果存在歧义，可查看子命令帮助：
    amazon-seller-pp-cli <command> --help
    。