# Product Import > Import products from Shopify, Amazon, Etsy, or CSV into a Mobazha store. Use when the user wants to migrate or copy listings from another platform. - Skill: `mobazha/product-import` (Agent Skill, multi-file: 4 files) - Install (CLI): `npx skillmds@latest add mobazha/product-import` - Raw SKILL.md: https://api.skillmd.com/api/skills/mobazha/product-import/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Data & Analytics - Author: mobazha (https://skillmd.com/u/mobazha) - Updated: 2026-09-10 - Page: https://skillmd.com/skills/mobazha/product-import --- # Product Import Import products from Shopify, Amazon, Etsy, and other e-commerce platforms into your Mobazha store. ## Overview This skill helps you migrate or copy product listings from existing platforms into Mobazha. Two approaches are available: - **Bulk Import (recommended)** — package products as a ZIP with JSON + images and upload in one call - **Individual Create** — create listings one at a time via the Admin API ## Bulk Import via MCP Tool If the store is connected via MCP, use the `listings_import_json` tool for the fastest bulk import: ```json { "import_json": "{\"listings\":[...], \"shippingProfiles\":[...]}", "images_base64": "{\"photo1.jpg\":\"\",\"photo2.jpg\":\"\"}" } ``` The tool builds a ZIP archive internally and uploads it to `POST /v1/listings/import/json`. ### import_json Schema ```json { "listings": [ { "slug": "unique-product-slug", "title": "Product Name", "contractType": "PHYSICAL_GOOD", "price": "29.99", "pricingCurrency": "USD", "description": "Product description", "shortDescription": "Brief summary", "productType": "Clothing", "tags": ["tag1", "tag2"], "condition": "NEW", "nsfw": false, "images": ["photo1.jpg", "photo2.jpg"], "introVideo": "demo.mp4", "processingTime": "1-3 business days", "grams": 500, "quantity": "100", "shippingProfileId": "Standard Shipping", "variants": [ { "selections": {"Color": "Red", "Size": "S"}, "price": "24.99", "quantity": "50", "productID": "SKU-RED-S" }, { "selections": {"Color": "Blue", "Size": "S"}, "price": "26.99", "quantity": "30", "productID": "SKU-BLU-S" } ] } ], "shippingProfiles": [ { "key": "Standard Shipping", "name": "Standard Shipping", "isDefault": true, "locationGroups": [ { "id": "lg-worldwide", "locationIds": [], "zones": [ { "id": "z-global", "name": "Global", "regions": ["ALL"], "rates": [ { "id": "r-standard", "name": "Standard Shipping", "price": "599", "currency": "USD", "estimatedDelivery": "7-14 business days" } ] } ] } ] } ], "collections": [ { "title": "Summer Collection", "description": "Best summer products", "image": "summer-banner.jpg", "products": ["unique-product-slug"] } ], "profile": { "name": "Store Name", "about": "Store description", "shortDescription": "Brief tagline", "location": "New York, US" } } ``` ### Shipping Profile Structure The `locationGroups` array follows the Shopify-inspired model: | Field | Type | Description | |-------|------|-------------| | `locationGroups[].id` | string | Unique ID for the location group | | `locationGroups[].locationIds` | string[] | Linked shipping locations (empty = global) | | `locationGroups[].zones[].id` | string | Unique ID for the zone | | `locationGroups[].zones[].name` | string | Display name (e.g., "Global", "Asia") | | `locationGroups[].zones[].regions` | string[] | ISO country codes, or `["ALL"]` for worldwide | | `locationGroups[].zones[].rates[].id` | string | Unique ID for the rate | | `locationGroups[].zones[].rates[].name` | string | Rate name (e.g., "Standard Shipping") | | `locationGroups[].zones[].rates[].price` | string | Price in smallest currency unit (e.g., "599" = $5.99) | | `locationGroups[].zones[].rates[].currency` | string | Currency code (e.g., "USD") | | `locationGroups[].zones[].rates[].estimatedDelivery` | string | Delivery estimate (e.g., "7-14 business days") | Listings reference profiles by `shippingProfileId`, which matches the `key` field in the import JSON. ### Contract Types | Type | Notes | |------|-------| | `PHYSICAL_GOOD` | Requires `shippingProfileId` matching a profile `key` | | `DIGITAL_GOOD` | No shipping needed | | `SERVICE` | No shipping needed | | `CRYPTOCURRENCY` | Token/coin listings (supports RWA fields) | ### Variants Each variant uses a `selections` map (not separate name/options fields): ```json { "selections": {"Color": "Red", "Size": "M"}, "price": "24.99", "quantity": "50", "productID": "SKU-001" } ``` ### Collections Group products into collections by referencing their slugs: ```json { "title": "New Arrivals", "products": ["product-slug-1", "product-slug-2"] } ``` For the complete field reference, see [`references/mapping.md`](references/mapping.md). ### Image Handling Images referenced in `listings[].images` must be provided as base64-encoded data in the `images_base64` parameter. The filenames must match exactly. To prepare images: 1. Download product images from the source platform 2. Base64-encode each image file 3. Build the `images_base64` JSON map: `{"filename.jpg": ""}` ## Bulk Import via Direct API For non-MCP contexts (e.g., shell scripts), build a ZIP file manually: ### ZIP Structure ``` my-import/ ├── import.json # Required: product data + shipping profiles + collections ├── images/ # Product images referenced in import.json │ ├── photo1.jpg │ ├── photo2.png │ └── ... └── videos/ # Optional: intro videos └── demo.mp4 ``` The JSON file can be named `import.json`, `listings.json`, or any `.json` filename. If it includes a `profile` section, the store profile is also updated. ### Upload ```bash curl -X POST "https://your-store.example.com/v1/listings/import/json" \ -H "Authorization: Bearer " \ -F "file=@my-import.zip" ``` ### Response ```json { "data": { "total": 10, "created": 8, "updated": 2, "failed": 0, "createdItems": [{ "slug": "product-1", "title": "Product 1" }], "updatedItems": [{ "slug": "product-2", "title": "Product 2" }], "errors": [] } } ``` ## References Detailed per-platform extraction guides and field mappings are in the `references/` directory: | File | Description | |------|-------------| | [`references/shopify-api.md`](references/shopify-api.md) | Shopify CSV export and Admin API data extraction | | [`references/amazon-scrape.md`](references/amazon-scrape.md) | Amazon product page scraping with BeautifulSoup | | [`references/mapping.md`](references/mapping.md) | Universal field mapping table (all platforms → Mobazha) | ## Supported Sources | Source | Method | Notes | |--------|--------|-------| | Shopify | CSV export or API | See [`references/shopify-api.md`](references/shopify-api.md) | | Amazon | Web scraping | See [`references/amazon-scrape.md`](references/amazon-scrape.md) | | Etsy | CSV export or API | Export from Etsy Shop Manager | | WooCommerce | CSV/JSON export | Export from WooCommerce admin | | Generic CSV | Manual | Any CSV with title, description, price, images | ## Method 1: Shopify Import 1. Export products via CSV or API — see [`references/shopify-api.md`](references/shopify-api.md) for details 2. Transform to Mobazha format — see [`references/mapping.md`](references/mapping.md) for field mapping 3. Download all product images locally 4. Build the `listings.json` (include `shippingProfiles` for physical goods) 5. Upload via `listings_import_json` MCP tool or direct ZIP API ## Method 2: Amazon Product Import 1. Collect product URLs or ASINs to import 2. Extract product data — see [`references/amazon-scrape.md`](references/amazon-scrape.md) for scraping code and DOM selectors 3. Transform to Mobazha JSON format — see [`references/mapping.md`](references/mapping.md) 4. Download images locally (use high-res URLs: replace `_AC_US40_` with `_AC_SL1500_`) 5. Upload via `listings_import_json` MCP tool or direct ZIP API **Important**: Respect robots.txt and rate limits; use 3-5 second delays between requests; verify pricing before import ## Method 3: Individual Listing Create For small imports (< 10 products), create listings one at a time via the `listings_create` MCP tool: ```json { "listing_json": "{\"slug\":\"my-product\",\"metadata\":{\"contractType\":\"DIGITAL_GOOD\",...},\"item\":{\"title\":\"...\",\"price\":\"9.99\",...}}" } ``` Or via the Admin API: ``` POST /v1/listings Content-Type: application/json Authorization: Bearer ``` Images must be uploaded first via `POST /v1/media/product-images` to obtain content hashes. The endpoint accepts a JSON array of `{"image": "", "filename": "photo.jpg"}` objects. ## Authentication ### MCP Connection If the store is connected via MCP (recommended), authentication is handled automatically through the MCP session token. ### Direct API Access For direct API calls, authenticate via OAuth to obtain a Bearer token, then include it in the `Authorization` header. ## Rate Considerations - Bulk import handles rate management internally — one ZIP upload imports all products - For individual creates, process one at a time and wait for each to succeed - Report progress to the user (e.g., "Created 15/50 listings...") - Large ZIP files (100+ products with images) may take 30-60 seconds to process ## Credential Handling - Never store, log, or display API tokens or passwords after use - For Shopify/Etsy API access, the user should provide their own API keys - API tokens can be scoped, revoked, and have optional expiry — generate them from Admin > AI Agents or via the auth tokens API ## Limitations - Product reviews cannot be imported (they are store-specific) - Physical goods require shipping profiles — include them in the import JSON - Payment options are set at the store level, not per-product - Digital product files must be re-uploaded to Mobazha - Maximum ZIP size: 300 MB (configurable) - Maximum video size per listing: 15 MB