Skill

amazon-seller

Read FBA inventory, orders, sales reports, listings, and catalog data for an Amazon seller account.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use amazon-seller

Choose if

You operate an Amazon seller account and want an agent to read FBA inventory, orders, listings, catalog, and sales reports from the command line without writing a custom SP-API client. The CLI handles the LWA token dance, paginates correctly, and exposes typed exit codes for agent self-correction.

Avoid if

You don't have a seller account (the SP-API is sellers-only), or you need to mutate Amazon state — create shipments, cancel orders, edit listings, manage advertising. This CLI is strictly read-only against the Selling Partner API.

Risk Flags

  • HIGH auth Requires a self-authorized Selling Partner API private application with LWA credentials. Refresh token is exchanged for an access token on first call and the access token is cached locally — treat the credentials store as sensitive.
  • MEDIUM scope Read-only verbs (inventory, orders, reports, listings, catalog). No order cancellation, no listing mutation, no shipment creation.
  • MEDIUM rate_limit Amazon SP-API enforces per-endpoint rate limits (not documented numerically in this README). Bulk catalog/orders queries can throttle.
  • LOW scope Amazon's pagination contract requires nextToken to be the only query parameter when set — agents passing extra filters with nextToken will get rejected requests.

Cost

Type: Usage based · Free tier: Selling Partner API itself has no per-call fee for standard reports on most marketplaces, but access depends on having an active seller account in good standing.

Hidden costs

  • The CLI is free, but using it requires an Amazon Seller Central account and a self-authorized private Selling Partner API application. Amazon may charge for some report types depending on the seller program.

Install

Default

npx -y @mvanhorn/printing-press install amazon-seller
# Set LWA credentials from your SP-API private application
export AMAZON_SP_API_CLIENT_ID=<lwa-client-id>
export AMAZON_SP_API_CLIENT_SECRET=<lwa-client-secret>
export AMAZON_SP_API_REFRESH_TOKEN=<seller-refresh-token>

Setup docs →

Estimated time to first success: ~30 min

Dependencies

Minimum runtime: Node.js 18+ (or Go 1.26.3+ for source install); active Amazon Seller Central account + self-authorized SP-API private app

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT