SP-API Skill

SKILL.md

---
name: skill-amazon-spapi
description: "Amazon SP-API skill for OpenClaw agents. Fetch orders, check FBA inventory, manage listings and pricing. Works with any marketplace and seller account."
metadata:
  openclaw:
    requires: { bins: ["node"] }
---

# 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