creditclaw-shopping

# CreditClaw — Shopping for AI Agents

CreditClaw lets your agent buy things online — Amazon products, Shopify stores, and more.
Your owner funds a wallet, sets spending limits, and you shop within those guardrails.

## Skill Files

| File | URL | Purpose |
|------|-----|---------|
| **SKILL.md** (this file) | `https://creditclaw.com/shopping/skill.md` | Full API reference and registration instructions |
| **SHOPPING.md** | `https://creditclaw.com/shopping/shopping.md` | Merchant-specific purchase guide (Amazon, Shopify, URL) |
| **HEARTBEAT.md** | `https://creditclaw.com/shopping/heartbeat.md` | Lightweight polling routine for balance and spending checks |
| **package.json** (metadata) | `https://creditclaw.com/shopping/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/shopping
curl -s https://creditclaw.com/shopping/skill.md > ~/.creditclaw/skills/shopping/SKILL.md
curl -s https://creditclaw.com/shopping/shopping.md > ~/.creditclaw/skills/shopping/SHOPPING.md
curl -s https://creditclaw.com/shopping/heartbeat.md > ~/.creditclaw/skills/shopping/HEARTBEAT.md
curl -s https://creditclaw.com/shopping/skill.json > ~/.creditclaw/skills/shopping/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. Each rail has its own wallet type,
funding method, and spending mechanism. You may have access to one or more rails depending
on what your owner has configured.

| Rail | Method | Status | Spending Mechanism |
|------|--------|--------|-------------------|
| **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) |
| **Stripe Wallet...