Amazon Seller CLI

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

Learn more at Amazon Seller.

Created by @cathrynlavery (Cathryn Lavery).

Quick Start

1. Install

See Install above.

2. Set Up Credentials

Self-authorize your private application in the provider console, export the OAuth client ID, OAuth client secret, and refresh token, then run 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

The CLI exchanges the refresh token for an access token on the first live request and caches the access token locally.

3. Verify Setup

amazon-seller-pp-cli doctor

This checks your configuration and credentials.

4. Try Your First Command

amazon-seller-pp-cli sellers marketplaces
amazon-seller-pp-cli fba-inventory list --granularity-type Marketplace --granularity-id ATVPDKIKX0DER --marketplace-ids ATVPDKIKX0DER

Usage

Run amazon-seller-pp-cli --help for the full command reference and flag list.

Commands

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 identifiersType.

fba-inventory

Inspect Fulfillment by Amazon inventory summaries.

• amazon-seller-pp-cli fba-inventory list - List FBA inventory summaries. For North America marketplace-level inventory, pass granularityType=Marketplace, granularityId=ATVPDKIKX0DER, and marketplaceIds=ATVPDKIKX0DER.

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 remains a JSON object.
• 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 nextToken.

sellers

Verify seller authorization and list marketplace participations.

• amazon-seller-pp-cli sellers marketplaces - List marketplace participations for the authorized seller account.

Output Formats

# Human-readable table (default in terminal, JSON when piped)
amazon-seller-pp-cli sellers marketplaces

# JSON for scripting and agents
amazon-seller-pp-cli orders search --created-after 2026-04-01T00:00:00Z --marketplace-ids ATVPDKIKX0DER --max-results-per-page 5 --json

# Filter to specific fields
amazon-seller-pp-cli catalog get <asin> --marketplace-ids ATVPDKIKX0DER --json --select asin,attributes,summaries

# Dry run — show the request without sending
amazon-seller-pp-cli reports list --report-types GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL --marketplace-ids ATVPDKIKX0DER --dry-run

# Agent mode — JSON + compact + no prompts in one flag
amazon-seller-pp-cli listings search <seller-id> --marketplace-ids ATVPDKIKX0DER --page-size 3 --agent

Agent Usage

This CLI is designed for AI agent consumption:

• Non-interactive - never prompts, every input is a flag
• Pipeable - --json output to stdout, errors to stderr
• Filterable - --select id,name returns only fields you need
• Previewable - --dry-run shows the request without sending
• Explicit retries - add --idempotent to create retries when a no-op success is acceptable
• Confirmable - --yes for explicit confirmation of destructive actions
• Piped input - write commands can accept structured input when their help lists --stdin
• Offline-friendly - sync/search commands can use the local SQLite store when available
• Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.

Health Check

amazon-seller-pp-cli doctor

Verifies configuration, credentials, and connectivity to the API.

Configuration

Config file: ~/.config/amazon-seller-pp-cli/config.toml

Environment variables:

Name	Kind	Required	Description
SP_API_LWA_CLIENT_ID	auth_flow_input	Yes	Set during initial auth setup.
SP_API_LWA_CLIENT_SECRET	auth_flow_input	Yes	Set during initial auth setup.
SP_API_REFRESH_TOKEN	auth_flow_input	Yes	Set during initial auth setup.

Troubleshooting

Authentication errors (exit code 4)

• Run amazon-seller-pp-cli doctor to check credentials Not found errors (exit code 3)
• Check the resource ID is correct
• Run the list command to see available items

---

Generated by CLI Printing Press