openclaw-ecommerce

# OpenClaw E-commerce Skill

A local-first e-commerce toolkit that helps you monitor product prices, track orders, calculate margins, and get alerts when prices drop below your target.

## Commands

```bash
# Product Watchlist
ecom watch add "AirPods Pro" --url "https://example.com/product" --target 149.99
ecom watch list
ecom watch remove <id>

# Price Tracking
ecom price update <product-id> 139.99
ecom price history <product-id>

# Order Management
ecom order add "Bulk T-Shirts" --cost 250 --tracking "1Z999AA10123456784"
ecom order list
ecom order status <id>

# Margin Calculator
ecom margin --cost 10 --sell 25 --fees 15

# Alerts
ecom alert list --pending
ecom alert clear <id>
```

## Features
- **Price Watchlists** — Add products with target prices, get alerted when they drop
- **Price History** — Track price changes over time per product
- **Order Tracking** — Log orders with cost, tracking numbers, and status
- **Margin Calculator** — Calculate real profit margins after platform fees, shipping, and costs
- **Alert System** — Automatic alerts when watched prices hit your target
- **Interchange Files** — Publishes product and alert data as .md files for other agents to consume

## Architecture
- SQLite database (WAL mode) for all product, price, order, and alert data
- Generic price scraper (no API keys required for v1)
- Interchange .md files generated via `@openclaw/interchange` shared library
- `ops/` directory for shareable capability data, `state/` for private runtime data

## Installation

```bash
cd skills/ecommerce
npm install
```

## Use Cases
- Monitor competitor pricing for your products
- Track cost-of-goods for dropshipping or POD businesses
- Calculate break-even prices including all fees
- Get notified when raw materials or supplies drop in price
- Keep an audit trail of all orders and shipments

# openclaw-ecommerce

[![Tests](https://img.shields.io/badge/tests-13%20passing-brightgreen)]() [![Node](https://img.shields.io/badge/node-%3E%3D18-blue)]() [![License: MIT](https://img.shields.io/badge/license-MIT-yellow)]()

> E-commerce price monitoring, order tracking, and margin analysis.

Watch product prices across the web, get alerts when they drop, track your orders, and calculate margins — all from a single CLI. Built on SQLite for zero-dependency local operation.

## Features

- **Product watchlist** — track products by URL with target prices
- **Price history** — record and review price changes over time
- **Price alerts** — automatic alerts when prices hit targets
- **Order tracking** — manage orders with status and tracking numbers
- **Margin calculator** — compute profit, margin percentage, and fees
- **Interchange output** — publish price and alert data as `.md` files
- **Backup & restore** — full database backup and recovery

## Quick Start

```bash
cd skills/ecommerce
npm install

# Watch a product
node src/cli.js watch add "MacBook Air M4" --url https://apple.com/macbook-air --target 999

# Update price and check history
node src/cli.js price update 1 1099
node src/cli.js price history 1

# Track an order
node src/cli.js order add "MacBook Air M4" --tracking 1Z999AA10123456784

# Calculate margins
node src/cli.js margin --cost 750 --sell 1099 --fees 3
```

## CLI Reference

### Product Watchlist

```bash
ecom watch add <name> --url <url> [--target <price>]
ecom watch list
ecom watch remove <id>
```

### Price Tracking

```bash
ecom price history <product-id>
ecom price update <product-id> <new-price>
```

### Order Management

```bash
ecom order add <name> [--tracking <number>]
ecom order list [--status <status>]
ecom order update <id> [--status <status>] [--tracking <number>]
```

### Margin Calculator

```bash
ecom margin --cost <cost> --sell <sell> [--fees <percentage>]
```

### Alerts

```bash
ecom alert list [--pending]
ecom alert ack <id>
``...