Supplier Stock/Price Monitor

Monitor configured public supplier product pages for displayed price, stock, and availability changes.

What this Actor does

Normalize supplier SKU, price, currency, availability, and stock status with previous-value comparisons.

• Watch approved public supplier product URLs.
• Normalize product and stock observations.
• Report price or availability changes.

Who this is for

Procurement operations, Inventory planners, Commerce data teams.

Input

• Demo mode is the safe default and emits one deterministic fixture.
• Live mode processes at most maxItems configured inputs.
• startUrls: user-provided or approved public URLs.

Output

The default dataset uses the Actor-specific schema in .actor/DATASET_SCHEMA.json. Key fields include productName, sku, price, currency, availability, stockStatus, previousPrice, priceChange, changedFields, plus exact source, status, delta, confidence, warning, and fixture/live labels.

Data sources

• SUPPLIER-PUBLIC
• SITEMAPS-RSS

These are the registered catalog source IDs. Live inputs may also include buyer-provided or explicitly approved public supplier URLs; buyer inputs are not registered source IDs.

Demo run

Run examples/first-run.json. The row in examples/sample-output.json is labeled sourceStatus: fixture, isDemo: true, and is not live evidence.

Live-run behavior

Live mode processes only the configured Actor-specific inputs. Failures are returned as diagnostics or explicit errors; the runtime does not silently substitute unrelated source families.

Pricing

The runtime reads the effective Apify pay-per-event map after Actor.init() and writes each buyer-visible dataset record through the verified change-alert event, including the already scheduled pricing-record transition. It stops with an explicit configuration-drift error instead of emitting unmetered output. This package never defines or changes provider pricing.

Identity and visibility safety

This package targets only zentrafoundry/supplier-stock-price-monitor with Actor ID 7O08BE14cxTjShhq9. Any future release must find exactly one authenticated inventory match and abort on identity or visibility drift. Creating, cloning, upserting, duplicating, drafting, or privatizing the Actor is forbidden.

Limitations

• Only configured public or buyer-authorized supplier pages are processed.
• A displayed availability label is not a contractual inventory guarantee.
• Local tests and fixtures do not prove an Apify build, live run, Store content update, or Store readback.

Responsible use

Use only data you are authorized to process. Respect source terms, robots policies, privacy rules, and applicable law. Never place credentials, cookies, tokens, or private account data in URLs or logs.

Support

When reporting a problem, include the run ID, sanitized input shape, expected result, and observed result. Do not include secrets or private data.