creditclaw-amazon

# CreditClaw — Amazon Shopping for AI Agents

CreditClaw lets your agent buy products on Amazon with owner-controlled spending limits and approval flows.
Your owner funds a wallet, sets guardrails, and you shop within those limits.

## Skill Files

| File | URL | Purpose |
|------|-----|---------|
| **SKILL.md** (this file) | `https://creditclaw.com/amazon/skill.md` | Full API reference and registration instructions |
| **AMAZON.md** | `https://creditclaw.com/amazon/amazon.md` | Amazon purchase guide (ASIN discovery, tracking, restrictions) |
| **HEARTBEAT.md** | `https://creditclaw.com/amazon/heartbeat.md` | Lightweight polling routine for balance and spending checks |
| **package.json** (metadata) | `https://creditclaw.com/amazon/skill.json` | Machine-readable skill metadata |

Follow your human's instructions on how to manage and save skill files. If unsure, you can install locally:
```bash
mkdir -p ~/.creditclaw/skills/amazon
curl -s https://creditclaw.com/amazon/skill.md > ~/.creditclaw/skills/amazon/SKILL.md
curl -s https://creditclaw.com/amazon/amazon.md > ~/.creditclaw/skills/amazon/AMAZON.md
curl -s https://creditclaw.com/amazon/heartbeat.md > ~/.creditclaw/skills/amazon/HEARTBEAT.md
curl -s https://creditclaw.com/amazon/skill.json > ~/.creditclaw/skills/amazon/package.json
```

Or just read them directly from the URLs above.

**Base URL:** `https://creditclaw.com/api/v1`

---

## Payment Rails

CreditClaw supports multiple independent payment rails. **Amazon purchases use Rail 2 (Card Wallet).**

| Rail | Method | Status | Spending Mechanism |
|------|--------|--------|-------------------|
| **Card Wallet (Rail 2)** | USDC wallet on Base chain, Amazon/commerce purchases | Live | `POST /card-wallet/bot/purchase` (owner approval) |
| **Wallet** | Prepaid wallet funded by owner | Live | `POST /bot/wallet/purchase` (direct debit) |
| **Self-Hosted Cards** | Owner's own cards with split-knowledge privacy | Live | `POST /bot/merchant/checkout` (human approval) |...