Supplier Catalog Change Tracker with Alerting Actor

This Actor monitors supplier websites for catalog updates and notifies procurement teams with change diffs and alert severity.

How it works

• Input: list of supplier catalog URLs with CSS selectors for product SKU, name, price, and availability.
• Fetches HTML pages asynchronously.
• Extracts product catalogs using CSS selectors.
• Compares with previous catalog data (optional input).
• Generates added, removed, and changed product lists with a severity alert.
• Pushes results to the default dataset.

Input schema

{
  "type": "object",
  "properties": {
    "supplierCatalogUrls": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {"type": "string", "format": "uri"},
          "productSelectors": {
            "type": "object",
            "propertyNames": {"enum": ["sku", "name", "price", "availability"]},
            "additionalProperties": {"type": "string"}
          }
        },
        "required": ["url", "productSelectors"]
      },
      "minItems": 1
    },
    "previousCatalogs": {
      "type": "object",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "sku": {"type": "string"},
            "name": {"type": "string"},
            "price": {"type": "string"},
            "availability": {"type": "string"}
          },
          "required": ["sku"]
        }
      }
    }
  },
  "required": ["supplierCatalogUrls"]
}

Output schema

{
  "type": "object",
  "properties": {
    "url": {"type": "string"},
    "timestamp": {"type": "string"},
    "status": {"type": "string"},
    "added": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sku": {"type": "string"},
          "name": {"type": "string"},
          "price": {"type": "string"},
          "availability": {"type": "string"}
        },
        "required": ["sku"]
      }
    },
    "removed": {"type": "array", "items": {"$ref": "#/properties/added/items"}},
    "changed": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "sku": {"type": "string"},
          "diffs": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "old": {"type": "string"},
                "new": {"type": "string"}
              },
              "required": ["old", "new"]
            }
          }
        },
        "required": ["sku", "diffs"]
      }
    },
    "severity_score": {"type": "integer"},
    "alert_level": {"type": "string"}
  },
  "required": ["url", "status", "added", "removed", "changed", "severity_score", "alert_level"]
}

Example input

{
  "supplierCatalogUrls": [
    {
      "url": "https://www.supplier-example.com/catalog",
      "productSelectors": {
        "sku": ".sku",
        "name": ".product-name",
        "price": ".price",
        "availability": ".availability"
      }
    }
  ],
  "previousCatalogs": {}
}

Running

• Deploy the Actor on Apify platform.
• Use the input schema to provide supplier catalog URLs and selectors.
• The Actor outputs normalized diff reports to dataset.

License

MIT