# Skill Amazon Spapi

> Amazon SP-API skill for OpenClaw agents. Fetch orders, check FBA inventory, manage listings and pricing. Works with any marketplace and seller account.

- Skill: `modbender/skill-amazon-spapi` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add modbender/skill-amazon-spapi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/skill-amazon-spapi/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/skill-amazon-spapi

---


# Amazon SP-API Skill

Fetch orders, check FBA inventory, and manage listings — plug-and-play for any OpenClaw agent.

---

## Setup

### 1. Install dependency
```bash
npm install amazon-sp-api
```

### 2. Create credentials file
```json
{
  "lwaClientId": "amzn1.application-oa2-client.YOUR_CLIENT_ID",
  "lwaClientSecret": "YOUR_CLIENT_SECRET",
  "refreshToken": "Atzr|YOUR_REFRESH_TOKEN",
  "region": "eu",
  "marketplace": "YOUR_MARKETPLACE_ID",
  "sellerId": "YOUR_SELLER_ID"
}
```
Save as `amazon-sp-api.json`. Set `AMAZON_SPAPI_PATH` env var to point to it (default: `./amazon-sp-api.json`).

> **Regions:** `na` | `eu` | `fe`
> **Marketplace IDs:** [Full list](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids)

---

## Scripts

### `auth.js` — Test Connection
```bash
node scripts/auth.js
```

### `orders.js` — Orders
```bash
node scripts/orders.js --list                          # last 7 days
node scripts/orders.js --list --days 30
node scripts/orders.js --list --status Unshipped
node scripts/orders.js --list --out orders.json
node scripts/orders.js --get ORDER-ID
```

### `inventory.js` — FBA Inventory
```bash
node scripts/inventory.js
node scripts/inventory.js --sku "MY-SKU"
node scripts/inventory.js --out inventory.json
```

### `listings.js` — Listings & Pricing
```bash
node scripts/listings.js --get "MY-SKU"
node scripts/listings.js --update "MY-SKU" --price 99.00
node scripts/listings.js --update "MY-SKU" --price 99.00 --currency USD
```

---

## Notes
- Tokens auto-refresh via LWA — no manual management
- Keep credential files at `chmod 600`
- Respect SP-API rate limits per endpoint

## Related
- [skill-amazon-ads](https://github.com/Zero2Ai-hub/skill-amazon-ads) — Campaign & bid management