shelfshift 1.0.2

Developer toolkit for ecommerce catalog translation across URL/CSV sources and platform CSV targets.

Shelfshift

Shelfshift is a Python toolkit for translating ecommerce catalogs across platforms. It detects/imports product data from URL or CSV inputs, normalizes into a canonical model, and exports platform-specific CSV files.

Installation

pip install shelfshift

Or with uv:

uv add shelfshift
uv sync

Quick smoke test:

python -c "import shelfshift; print(shelfshift.__version__)"
shelfshift --help

Quick Start (CLI)

shelfshift convert ./source.csv --to shopify --out ./shopify.csv --report ./convert_report.json

Detect input kind/platform:

shelfshift detect ./source.csv
shelfshift detect "https://example.myshopify.com/products/demo-item"

Quick Start (Library)

from shelfshift import convert_csv

csv_bytes, report = convert_csv("./source.csv", target="shopify")
with open("./shopify.csv", "wb") as f:
    f.write(csv_bytes)

Support

• Python: >=3.10
• URL detection: shopify, woocommerce, squarespace, amazon, aliexpress
• URL import: shopify, woocommerce, squarespace
• CSV import/export: shopify, bigcommerce, wix, squarespace, woocommerce

Documentation

• Start here: Guides Index
• Library guides: Library Index
• CLI guides: CLI Index

Development Note

For repeated local CLI work, activate .venv and run commands directly:

source .venv/bin/activate
shelfshift --help

License

MIT. See LICENSE.