Shopify Catalog and Product Feed QA

Preflight Shopify catalog, storefront, and merchant-feed data for missing fields, variant errors, taxonomy gaps, and feed-to-page drift. Get exact issues plus an optional proposal-only fix file.

Start in 30 seconds

1. Select Try for free and run with no input for a labeled demo.
2. Supply sanitized catalog, storefront, and feed records.
3. Fix violations before submitting or debugging the downstream channel.

Price: $0.002 per resolved product audit, plus a $0.00005 start event. Unknown, failed, and demo results are free.

This Actor does not connect to Shopify or Google Merchant Center, crawl a storefront, or apply fixes automatically.

Features

• Deterministic Rule Evaluation:
  • Missing required metafields (e.g., custom care instructions, fabric specs, hazardous material ratings).
  • Unmapped Google Product Category (GMC) taxonomy.
  • Variant inconsistencies: missing SKU, missing barcode, zero/missing weight.
  • Pricing logic violations: inverted compareAtPrice < price.
  • Duplicate variant options.
  • Feed-to-page drift: price discrepancies or availability mismatches between catalog/feed and live storefront JSON-LD.
• Explicit Unknowns:
  • Unobserved evidence (e.g., omitted barcode, un-crawled storefront, absent feed records) is surfaced as explicit unknown states rather than falsely assumed compliant.
• Non-Destructive Fix Proposal:
  • When generateFixFile is enabled, outputs a proposals-only record preserving source product and variant IDs.
  • Changes are never automatically applied.
• Offline & Credential-Free:
  • Runs fully offline over sanitized storefront or export records.
  • Requires zero Shopify Admin or customer credentials.

Input

Input conforms to .actor/input_schema.json:

{
  "products": [
    {
      "id": "gid://shopify/Product/12345",
      "handle": "classic-cotton-tee",
      "title": "Classic Cotton Tee",
      "vendor": "Acme Apparel",
      "productType": "Apparel > Tops > T-Shirts",
      "googleProductCategory": "Apparel & Accessories > Clothing > Shirts & Tops",
      "variants": [
        {
          "id": "gid://shopify/ProductVariant/67890",
          "sku": "TEE-BLK-S",
          "barcode": "012345678905",
          "price": "25.00",
          "compareAtPrice": "30.00",
          "weight": 0.2,
          "weightUnit": "kg"
        }
      ],
      "metafields": [
        { "namespace": "custom", "key": "material", "value": "100% Cotton" }
      ],
      "rules": {
        "requiredMetafields": ["custom.material"],
        "requireGmcCategory": true,
        "requireSku": true,
        "requireBarcode": true
      }
    }
  ],
  "generateFixFile": true
}

Output

• Default Dataset: One item per audited product containing status (pass, violation, or unknown), detailed list of violations, and explicit unknowns.
• Key-Value Store OUTPUT: Run summary envelope containing aggregate counts (totalProducts, passedCount, violationCount, unknownCount), contract version, and timestamp.
• Key-Value Store FIXES_PROPOSAL: List of non-destructive fix proposals preserving source IDs and explaining rationale.

Local Development & Testing

Run behavioral and fixture tests locally using Node's native test runner:

$npm test

Catalog exports may be nonpublic. Use synthetic or authorized screenshots, minimize retained fields, and delete run datasets under your retention policy. Fix output is proposal-only and never invents a category, vendor, or brand. Support owner: Mehdi Badawi through the Apify Store support channel, with an initial-response target of two business days.