Shopify MAP Price Compliance & Delta Monitoring Sentinel

An enterprise-grade, stateful brand-protection utility built specifically for wholesale manufacturers, product brands, and e-commerce corporate compliance teams who need to monitor digital retail networks for price mutations and contract violations.

Unlike general e-commerce catalog dumpers that overwhelm your workflow with thousands of messy data lines, this Actor functions as an intelligent backend sentinel. It stores baseline state history using encrypted Key-Value memory and outputs ONLY target items where a retail price drop or a contractual MAP breach has actively occurred.

---

🔄 Understanding the Stateful Lifecycle (Crucial for First-Time Users)

Because this Actor tracks changes over time (deltas), its execution behavior shifts across chronological runs:

1. The Initial Run (Priming the Cache Baseline): When you run a target store domain for the first time, your dataset output will return 0 results. Under the hood, the engine is building an isolated, hashed Key-Value Store memory cache for that store, locking in the current live market pricing snapshot to act as tomorrow's baseline.
2. Subsequent Scheduled Runs (The Delta Calculation): On all future runs, the engine cross-references live incoming pricing data against your saved memory cache. The tool remains entirely silent until a price changes or breaks a threshold. The exact moment a merchant cuts a price or violates a compliance floor, that specific item row is instantly piped to your dashboard dataset grid.

---

📥 Input Architecture

The tool accepts a clean, minimalist JSON schema optimized for automated task scheduling and seamless integration with external B2B pipelines:

• urls (Array of Strings - Required): Target Shopify storefront root domains to monitor (e.g., ["https://chubbiesshorts.com", "https://gymshark.com"]).
• mapThresholds (Object Key-Value Pairs - Optional): Contractual Minimum Advertised Price limits mapped directly to standard lowercase product handle slug tokens (e.g., {"arrival-5-shorts": 150.00, "crest-t-shirt": 35.00}).
• maxConcurrency (Integer): Operational ceiling control (Default: 2) to perfectly balance execution speeds against cloud compute resource consumption preferences.
• requestDelayMs (Integer): Politeness delay spacing (Default: 250) enforced between outbound requests during the light-fetch stage to seamlessly blend in with organic consumer traffic.

---

📤 Semantic Output Feed

When a pricing event trips the internal monitoring filters, the scraper delivers a highly organized, streamlined data array stripped of unrelated e-commerce clutter. Output cells are clearly labeled with consolidated event flags to preserve your legal evidence trail:

{
  "store_url": "https://gymshark.com",
  "product_title": "Arrival 5\" Shorts",
  "product_handle": "arrival-5-shorts",
  "previous_price": 26.00,
  "current_price": 24.00,
  "alert_type": "MAP_VIOLATION_AND_PRICE_DROP"
}

Alert Type Key Glossaries:

• MAP_VIOLATION_AND_PRICE_DROP: A merchant actively cut their price and fell beneath your contractual pricing floor.
• MAP_VIOLATION: The price remained stable from the previous check but sits actively below your allowed compliance threshold.
• PRICE_DROP: A merchant cut their retail price, but the drop did not violate your lower MAP safety floor.

---

💎 Premium Enterprise Feature Integration

• API-First Efficiency: Automatically appends /products.json?limit=250 to target storefront architectures to fetch raw text data payloads instantly, bypassing heavy image loading and saving over 90%+ in cloud server processing bills.
• Playwright Browser Fallback: Built with adaptive resilience. If a specialized retail storefront firewall blocks a direct endpoint pull, the engine automatically catches the error and spins up an invisible Chrome instance to pull DOM parameters without crashing the batch loop.
• Infrastructure Circuit Breaker: Programmed with automated self-healing network monitors. If a tracked retail site goes completely down or returns continuous server errors, the Actor pauses heavy connection retries for 6 hours to protect your compute budget from being drained by bad inputs.