Mobazha 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.

Security Scan

The skill's instructions generally match an import/migration tool, but it omits declaring required credentials and explicitly advises scraping techniques (IP rotation/residential proxies/headless browsers) that could be used to evade protections — this mismatch and the scraping guidance warrant caution.

Purpose & Capability

The name/description (product import into Mobazha) matches the included instructions and mapping docs. However the SKILL.md references an MCP 'listings_import_json' tool and examples that require an Authorization token or Shopify API token but the skill declares no required credentials or env vars. That omission is a mismatch (the skill expects API tokens but doesn't declare them).

Instruction Scope

Instructions include step-by-step guidance for scraping Amazon (full scraping code, DOM selectors), and explicitly recommends IP rotation / residential proxies and headless browsers to avoid blocks. While scraping can be legitimate for migrating a user's own listings, recommending evasion techniques broadens the scope into potentially abusive behavior and increases legal/ethical risk. The instructions also instruct downloading and rehosting images — normal for import but notable for data movement.

Install Mechanism

This is an instruction-only skill with no install spec and no code files executed by the platform, so there is low risk of arbitrary code being written to disk by the skill itself.

Credentials

The skill declares no required environment variables, yet the docs and examples expect secrets/tokens (store Authorization bearer token for the Mobazha API, Shopify X-Shopify-Access-Token, potentially Amazon PA-API credentials). Not declaring these required credentials is an incoherence and could cause users to unknowingly supply sensitive tokens without clear indication of where/why they're needed.

Persistence & Privilege

The skill is not always-enabled, does not request persistent system-level privileges, and being instruction-only it does not modify other skills or system settings.

What to consider before installing

This skill appears to do what it says (migrate product listings), but take these precautions before using or installing it: - Do not feed real API tokens or store bearer tokens into a skill unless you trust the source; the SKILL.md uses Authorization tokens and Shopify access tokens but the package doesn't declare them. - The included Amazon scraping guide explicitly recommends IP rotation/residential proxies and headless browsers to evade blocks — that can violate site terms of service and may be legally or ethically risky. Only use scraping instructions on sites you own or have explicit permission to scrape. - If you plan to import, verify the existence and behavior of the referenced MCP tool (listings_import_json) and confirm how authentication should be supplied; ask the skill author to declare required env vars/credentials in the metadata. - For safety, perform imports on a test store first, and avoid rehosting content you don't have rights to (images, text). - If you need higher assurance, request from the publisher: (1) explicit list of required credentials, (2) clarification about MCP/tool availability, and (3) removal or moderation of instructions that encourage evading anti-scraping defenses.

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:

{
  "import_json": "{\"listings\":[...], \"shippingProfiles\":[...]}",
  "images_base64": "{\"photo1.jpg\":\"<base64>\",\"photo2.jpg\":\"<base64>\"}"
}

The tool builds a ZIP archive internally and uploads it to POST /v1/listings/import/json.

import_json Schema

{
  "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": [
        {
          "name": "Worldwide",
          "locations": [{ "country": "ALL" }],
          "shippingOptions": [
            { "name": "Standard", "type": "FIXED_PRICE", "price": "5.00" }
          ]
        }
      ]
    }
  ],
  "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"
  }
}

Contract Types

Type	Notes
PHYSICAL_GOOD	Requires shippingProfileId matching a profile key/name
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):

{ "selections": {"Color": "Red", "Size": "M"}, "price": "24.99", "quantity": "50", "productID": "SKU-001" }

Collections

Group products into collections by referencing their slugs:

{ "title": "New Arrivals", "products": ["product-slug-1", "product-slug-2"] }

For the complete field reference, see 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": "<base64-data>"}

Bulk Import via Direct API

For non-MCP contexts (e.g., shell scripts), build a ZIP file manually:

ZIP Structure

my-import/
├── listings.json          # Required: product data + shipping profiles
├── profile.json           # Optional: store profile data
├── images/                # Product images referenced in listings.json
│   ├── photo1.jpg
│   ├── photo2.png
│   └── ...
└── videos/                # Optional: intro videos
    └── demo.mp4

Upload

curl -X POST "https://your-store.example.com/v1/listings/import/json" \
  -H "Authorization: Bearer <token>" \
  -F "file=@my-import.zip"

Response

{
  "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	Shopify CSV export and Admin API data extraction
references/amazon-scrape.md	Amazon product page scraping with BeautifulSoup
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
Amazon	Web scraping	See 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 for details
2. Transform to Mobazha format — see 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 for scraping code and DOM selectors
3. Transform to Mobazha JSON format — see 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:

{
  "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 <token>

Images must be uploaded first via POST /v1/media to obtain content hashes.

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 keys or passwords after use
• For Shopify/Etsy API access, the user should provide their own API keys
• MCP tokens are session-scoped and managed by the platform

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