Metadata-Version: 2.4
Name: ecommerce-warmup-kit
Version: 0.2.1
Summary: Amazon, eBay, Etsy, and Shopify browser warmup recipes for Multilogin X. CLI: shop-warmup
Project-URL: Homepage, https://pypi.org/project/ecommerce-warmup-kit/
Project-URL: Documentation, https://pypi.org/project/ecommerce-warmup-kit/
Project-URL: Repository, https://github.com/multilogin-automation
Project-URL: Changelog, https://pypi.org/project/ecommerce-warmup-kit/
Author: ecommerce-warmup-kit contributors
License-Expression: MIT
License-File: LICENSE
Keywords: amazon-seller-warmup,amazon-warmup,ebay-warmup,ecommerce-cadence,ecommerce-warmup,etsy-warmup,marketplace-aging,marketplace-warmup,retail-browser-warmup,seller-warmup,shop-browse-cadence,shopify-warmup
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Requires-Dist: click>=8.1
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# ecommerce-warmup-kit

**Marketplace browser warmup** — Amazon, eBay, Etsy, and Shopify cadence recipes.

[![PyPI version](https://img.shields.io/pypi/v/ecommerce-warmup-kit.svg)](https://pypi.org/project/ecommerce-warmup-kit/)
[![Python versions](https://img.shields.io/pypi/pyversions/ecommerce-warmup-kit.svg)](https://pypi.org/project/ecommerce-warmup-kit/)
[![License: MIT](https://img.shields.io/pypi/l/ecommerce-warmup-kit.svg)](https://pypi.org/project/ecommerce-warmup-kit/)
[![GitHub](https://img.shields.io/badge/org-multilogin--automation-181717?logo=github)](https://github.com/multilogin-automation)

```bash
pip install ecommerce-warmup-kit
shop-warmup plan --marketplace amazon
```

CLI: **`shop-warmup`** · Python **3.10+** · planner only

> **Coupon hubs:** `SAAS50` — [anti-detect.github.io](https://anti-detect.github.io/) · [SaaSVerdict](https://saasverdict.com/). [Affiliate disclosure](docs/AFFILIATE.md).

## Problem

New seller/browser accounts on Amazon and eBay get flagged without phased browse — generic [mlx-warmup-kit](https://pypi.org/project/mlx-warmup-kit/) does not encode marketplace-specific cadence.

## Install

```bash
pip install ecommerce-warmup-kit
```

## Quick start

```bash
shop-warmup default --marketplace ebay
shop-warmup plan --marketplace etsy --format shell -o warmup.sh
shop-warmup validate examples/amazon-warmup.yaml
```

## CLI

| Command | Purpose |
|---------|---------|
| `shop-warmup schema FILE` | Pydantic schema check only |
| `shop-warmup init -d DIR` | Create starter `.shop-warmup/recipe.yaml` |
| `shop-warmup template -o FILE` | Write starter recipe YAML/JSON |
| `shop-warmup plan` | Markdown, shell, or JSON plan (`--from FILE`) |
| `shop-warmup validate FILE --format json` | JSON validation report |
| `shop-warmup default` | Default YAML to stdout |
| `shop-warmup template` | Starter YAML |
| `shop-warmup validate FILE` | Validate recipe |
| `shop-warmup list` | Supported marketplaces |
| `shop-warmup list --format json` | Marketplaces + step counts JSON |
| `shop-warmup catalog --format json` | Example recipe index |
| `shop-warmup steps` | Default steps (`--format json`) |
| `shop-warmup dry-run` | Preview steps (`--format json`) |
| `shop-warmup --show-deal` | Opt-in `SAAS50` |

**Toolkit pipeline:** `bot-lint audit` → `shop-warmup plan --format shell` → `farm-runner`

## Limitations

Planner only — no checkout automation or payment fraud.

## Production

`bot-lint audit` → `shop-warmup plan` → [automation-farm-runner](https://pypi.org/project/automation-farm-runner/). [docs/FAQ.md](docs/FAQ.md)

## Related tools (on PyPI)

| Package | CLI | Role |
|---------|-----|------|
| [mlx-warmup-kit](https://pypi.org/project/mlx-warmup-kit/) | `mlx-warmup` | Generic browser warmup |
| [antibot-profile-lint](https://pypi.org/project/antibot-profile-lint/) | `bot-lint` | Checkout lint |
| [human-input-kit](https://pypi.org/project/human-input-kit/) | `human-input` | Mouse cadence |
| [proxy-lane-checker](https://pypi.org/project/proxy-lane-checker/) | `proxy-lane` | Proxy geo |

## License

MIT

---

**Partner:** Multilogin · `SAAS50` · [github.com/multilogin-automation](https://github.com/multilogin-automation)
