# xjli360/sealeap-ecommerce-skills architecture

> Architecture diagram of the GitHub repository xjli360/sealeap-ecommerce-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xjli360/sealeap-ecommerce-skills
- Repository: https://github.com/xjli360/sealeap-ecommerce-skills

## Overview

SeaLeap eCommerce Skills is a collection of portable, task-specific AI-agent workflows for eight marketplaces—not a single runtime service. A seller selects a skill, supplies task inputs, and uses its instructions and references to produce a decision or operational deliverable. The README describes broad coverage across product selection, listing and content, fulfillment, advertising, and analysis. Sampled scripts add offline calculators and data/plan checks; they are separate utilities, not a shared execution pipeline. Relationships below follow documented usage; unsampled skill internals are represented at their platform directories.

Main entry points: [`sealeap-amazon-skills/ozon`](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/ozon) (OZON Skills), [`sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/mpstats_read.py`](https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/mpstats_read.py) (MPstats Read Probe), [`sealeap-amazon-skills/shopify`](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/shopify) (Shopify Skills), [`sealeap-amazon-skills/etsy`](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/etsy) (Etsy Skills)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_marketplaces_a["Marketplace Workflows"]
  node_shopify["Shopify Skills"]
  node_etsy["Etsy Skills"]
  node_ebay["eBay Skills"]
end

subgraph group_marketplaces_b["Marketplace Workflows"]
  node_tiktok["TikTok Shop Skills"]
  node_walmart["Walmart Skills"]
  node_mercado["Mercado Libre Skills"]
end

subgraph group_marketplaces_c["Marketplace Workflows"]
  node_ozon["OZON Skills"]
  node_wayfair["Wayfair Skills"]
end

subgraph group_offline_tools["Offline Tools"]
  node_ozon_probe["MPstats Read Probe<br/>[mpstats_read.py]"]
  node_ozon_validate["MPstats Data Check<br/>[validate_data.py]"]
  node_tiktok_econ["TikTok Economics<br/>[unit_economics.py]"]
  node_mercado_econ["Mercado Economics<br/>[unit_economics.py]"]
  node_walmart_boxes["WFS Box Check"]
  node_wayfair_cartons["Wayfair Carton Check<br/>[check_cartons.py]"]
  node_wayfair_econ["Wayfair Economics"]
end

node_seller(("Seller or Agent"))
node_mpstats[("MPstats Data")]

node_seller -->|"selects task"| node_shopify
node_seller -->|"selects task"| node_etsy
node_seller -->|"selects task"| node_ebay
node_seller -->|"selects task"| node_tiktok
node_seller -->|"selects task"| node_walmart
node_seller -->|"selects task"| node_mercado
node_seller -->|"selects task"| node_ozon
node_seller -->|"selects task"| node_wayfair
node_shopify -->|"delivers task result"| node_seller
node_etsy -->|"delivers task result"| node_seller
node_ebay -->|"delivers task result"| node_seller
node_tiktok -->|"delivers task result"| node_seller
node_walmart -->|"delivers task result"| node_seller
node_mercado -->|"delivers task result"| node_seller
node_ozon -->|"delivers task result"| node_seller
node_wayfair -->|"delivers task result"| node_seller
node_mpstats -->|"required input"| node_ozon
node_seller -->|"runs locally"| node_ozon_probe
node_ozon_probe -->|"reads API data"| node_mpstats
node_seller -->|"checks dataset"| node_ozon_validate
node_ozon_validate -->|"uses probe module"| node_ozon_probe
node_seller -->|"runs scenario"| node_tiktok_econ
node_seller -->|"runs scenario"| node_mercado_econ
node_seller -->|"checks manifest"| node_walmart_boxes
node_seller -->|"checks plan"| node_wayfair_cartons
node_seller -->|"runs scenario"| node_wayfair_econ

click node_shopify "https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/shopify"
click node_etsy "https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/etsy"
click node_ebay "https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/ebay"
click node_tiktok "https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/tiktokshop"
click node_walmart "https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/walmart"
click node_mercado "https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/mercadolibre"
click node_ozon "https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/ozon"
click node_wayfair "https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/wayfair"
click node_ozon_probe "https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/mpstats_read.py"
click node_ozon_validate "https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/validate_data.py"
click node_tiktok_econ "https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/tiktokshop/sealeap-tiktokshop-unit-economics/scripts/unit_economics.py"
click node_mercado_econ "https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/mercadolibre/sealeap-mercadolibre-unit-economics/scripts/unit_economics.py"
click node_walmart_boxes "https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/walmart/sealeap-walmart-wfs-box-reconciliation/scripts/check_box_manifest.py"
click node_wayfair_cartons "https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/wayfair/sealeap-wayfair-order-multibox/scripts/check_cartons.py"
click node_wayfair_econ "https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/wayfair/sealeap-wayfair-wholesale-economics/scripts/wholesale_contribution.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_shopify,node_etsy,node_ebay toneBlue
class node_tiktok,node_walmart,node_mercado,node_mpstats toneAmber
class node_ozon,node_wayfair toneMint
class node_ozon_probe,node_ozon_validate,node_tiktok_econ,node_mercado_econ,node_walmart_boxes,node_wayfair_cartons,node_wayfair_econ toneRose
class node_seller toneIndigo
```

## Components

### Marketplace Workflows

- [Shopify Skills](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/shopify): `sealeap-amazon-skills/shopify`
- [Etsy Skills](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/etsy): `sealeap-amazon-skills/etsy`
- [eBay Skills](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/ebay): `sealeap-amazon-skills/ebay`

### Marketplace Workflows

- [TikTok Shop Skills](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/tiktokshop): `sealeap-amazon-skills/tiktokshop`
- [Walmart Skills](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/walmart): `sealeap-amazon-skills/walmart`
- [Mercado Libre Skills](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/mercadolibre): `sealeap-amazon-skills/mercadolibre`

### Marketplace Workflows

- [OZON Skills](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/ozon): `sealeap-amazon-skills/ozon`
- [Wayfair Skills](https://github.com/xjli360/sealeap-ecommerce-skills/tree/main/sealeap-amazon-skills/wayfair): `sealeap-amazon-skills/wayfair`

### Offline Tools

- [MPstats Read Probe](https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/mpstats_read.py): `sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/mpstats_read.py`
- [MPstats Data Check](https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/validate_data.py): `sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/validate_data.py`
- [TikTok Economics](https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/tiktokshop/sealeap-tiktokshop-unit-economics/scripts/unit_economics.py): `sealeap-amazon-skills/tiktokshop/sealeap-tiktokshop-unit-economics/scripts/unit_economics.py`
- [Mercado Economics](https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/mercadolibre/sealeap-mercadolibre-unit-economics/scripts/unit_economics.py): `sealeap-amazon-skills/mercadolibre/sealeap-mercadolibre-unit-economics/scripts/unit_economics.py`
- [WFS Box Check](https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/walmart/sealeap-walmart-wfs-box-reconciliation/scripts/check_box_manifest.py): `sealeap-amazon-skills/walmart/sealeap-walmart-wfs-box-reconciliation/scripts/check_box_manifest.py`
- [Wayfair Carton Check](https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/wayfair/sealeap-wayfair-order-multibox/scripts/check_cartons.py): `sealeap-amazon-skills/wayfair/sealeap-wayfair-order-multibox/scripts/check_cartons.py`
- [Wayfair Economics](https://github.com/xjli360/sealeap-ecommerce-skills/blob/main/sealeap-amazon-skills/wayfair/sealeap-wayfair-wholesale-economics/scripts/wholesale_contribution.py): `sealeap-amazon-skills/wayfair/sealeap-wayfair-wholesale-economics/scripts/wholesale_contribution.py`

### Other components

- **Seller or Agent**
- **MPstats Data**

## Connections

- Seller or Agent → Shopify Skills: selects task (evidence: `README.md`)
- Seller or Agent → Etsy Skills: selects task (evidence: `README.md`)
- Seller or Agent → eBay Skills: selects task (evidence: `README.md`)
- Seller or Agent → TikTok Shop Skills: selects task (evidence: `README.md`)
- Seller or Agent → Walmart Skills: selects task (evidence: `README.md`)
- Seller or Agent → Mercado Libre Skills: selects task (evidence: `README.md`)
- Seller or Agent → OZON Skills: selects task (evidence: `README.md`)
- Seller or Agent → Wayfair Skills: selects task (evidence: `README.md`)
- Shopify Skills → Seller or Agent: delivers task result (evidence: `README.md`)
- Etsy Skills → Seller or Agent: delivers task result (evidence: `README.md`)
- eBay Skills → Seller or Agent: delivers task result (evidence: `README.md`)
- TikTok Shop Skills → Seller or Agent: delivers task result (evidence: `README.md`)
- Walmart Skills → Seller or Agent: delivers task result (evidence: `README.md`)
- Mercado Libre Skills → Seller or Agent: delivers task result (evidence: `README.md`)
- OZON Skills → Seller or Agent: delivers task result (evidence: `README.md`)
- Wayfair Skills → Seller or Agent: delivers task result (evidence: `README.md`)
- MPstats Data → OZON Skills: required input (evidence: `README.md`)
- Seller or Agent → MPstats Read Probe: runs locally (evidence: `sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/mpstats_read.py`)
- MPstats Read Probe → MPstats Data: reads API data (evidence: `sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/mpstats_read.py`)
- Seller or Agent → MPstats Data Check: checks dataset (evidence: `sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/validate_data.py`)
- MPstats Data Check → MPstats Read Probe: uses probe module (evidence: `sealeap-amazon-skills/ozon/sealeap-ozon-mpstats-data-audit/scripts/validate_data.py`)
- Seller or Agent → TikTok Economics: runs scenario (evidence: `sealeap-amazon-skills/tiktokshop/sealeap-tiktokshop-unit-economics/scripts/unit_economics.py`)
- Seller or Agent → Mercado Economics: runs scenario (evidence: `sealeap-amazon-skills/mercadolibre/sealeap-mercadolibre-unit-economics/scripts/unit_economics.py`)
- Seller or Agent → WFS Box Check: checks manifest (evidence: `sealeap-amazon-skills/walmart/sealeap-walmart-wfs-box-reconciliation/scripts/check_box_manifest.py`)
- Seller or Agent → Wayfair Carton Check: checks plan (evidence: `sealeap-amazon-skills/wayfair/sealeap-wayfair-order-multibox/scripts/check_cartons.py`)
- Seller or Agent → Wayfair Economics: runs scenario (evidence: `sealeap-amazon-skills/wayfair/sealeap-wayfair-wholesale-economics/scripts/wholesale_contribution.py`)
