# Product Availability Monitor (`mighty_monk/product-availability-monitor`) Actor

Monitor e-commerce product URLs for stock and price changes. Supports Shopify products.json, WooCommerce pages, and schema.org Product parsing with snapshot-based change detection.

- **URL**: https://apify.com/mighty\_monk/product-availability-monitor.md
- **Developed by:** [Harsh](https://apify.com/mighty_monk) (community)
- **Categories:** E-commerce, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 product monitoreds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Product Availability Monitor

Monitor e-commerce product URLs for **stock availability** and **price changes** across Shopify, WooCommerce, and generic schema.org storefronts. Each run returns structured JSON with change detection against the previous snapshot.

### Features

- **Multi-platform parsing** — Shopify `/products.json`, WooCommerce HTML heuristics, and schema.org `Product` JSON-LD
- **Change detection** — compares `inStock` and `price` with the previous run via KV store or `previousSnapshot` input
- **Structured output** — `url`, `inStock`, `price`, `currency`, `lastChange`, `timestamp`
- **JSON run report** — summary saved to key-value store key `OUTPUT`
- **Retries & rate limiting** — configurable `maxRequestRetries` and `maxRequestsPerMinute`
- **Logging** — per-product status and run summary in Actor logs

### Input

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `productUrls` | `object[]` | — | Product page URLs to monitor (**required**) |
| `previousSnapshot` | `object` | — | Optional URL → state map to override KV snapshot |
| `persistSnapshot` | `boolean` | `true` | Save `PRODUCT_SNAPSHOT` for the next run |
| `maxRequestRetries` | `integer` | `3` | HTTP retry count |
| `maxRequestsPerMinute` | `integer` | `30` | Request rate limit |
| `useProxy` | `boolean` | `false` | Use Apify Proxy |

#### Example input

```json
{
    "productUrls": [
        { "url": "https://shop.polymer80.com/products/pf940v2-80-textured-pistol-frame" },
        { "url": "https://woocommerce.com/products/woocommerce-subscriptions/" }
    ],
    "persistSnapshot": true,
    "maxRequestRetries": 3,
    "maxRequestsPerMinute": 30
}
```

See `examples/input.json` and `storage/key_value_stores/default/INPUT.json`.

### Output

#### Dataset (per product)

| Field | Type | Description |
| --- | --- | --- |
| `url` | `string` | Product page URL |
| `inStock` | `boolean` | Whether the product appears available |
| `price` | `number \| null` | Parsed price when available |
| `currency` | `string \| null` | ISO currency code when available |
| `lastChange` | `string` | `first_run`, `no_change`, or change description |
| `timestamp` | `string` | ISO timestamp of the check |
| `parseMethod` | `string` | `shopify`, `woocommerce`, `schema.org`, or `unknown` |
| `title` | `string \| null` | Product title when parsed |
| `error` | `string` | Present when the URL could not be monitored |

#### `lastChange` values

- `first_run` — no previous snapshot for this URL
- `no_change` — stock and price unchanged
- `inStock: false -> true; price: 29.99 -> 24.99 USD` — human-readable diff

#### Key-value store

| Key | Description |
| --- | --- |
| `OUTPUT` | JSON run report with totals and full `results` array |
| `PRODUCT_SNAPSHOT` | Snapshot used on the next scheduled run |

#### Example report (`OUTPUT`)

```json
{
    "timestamp": "2026-07-05T12:00:00.000Z",
    "totalProducts": 2,
    "changed": 1,
    "inStock": 1,
    "outOfStock": 1,
    "errors": 0,
    "results": []
}
```

See `examples/example-output.json`.

### Parsing strategy

1. **Shopify** — product URLs under `/products/` are fetched via `{url}.json` first; HTML fallback is used on failure.
2. **WooCommerce** — Woo-specific selectors plus schema.org JSON-LD on product pages.
3. **schema.org** — generic `Product` JSON-LD extraction for other storefronts.

### Scheduling

Run this Actor on a schedule (e.g. every hour). With `persistSnapshot: true`, each run automatically compares against the last successful snapshot stored in the Actor key-value store.

### Local development

```bash
npm install
npm run lint
npm run build
npm test
apify run --purge
```

### Pricing

Pay per result: **$0.003** per dataset item (`apify-default-dataset-item`).

### License

ISC

# Actor input Schema

## `productUrls` (type: `array`):

E-commerce product page URLs to monitor for stock and price changes.

## `previousSnapshot` (type: `object`):

Optional map of URL to previous product state. When omitted, the Actor loads PRODUCT\_SNAPSHOT from the key-value store.

## `persistSnapshot` (type: `boolean`):

Save the latest product states to PRODUCT\_SNAPSHOT in the key-value store for the next scheduled run.

## `maxRequestRetries` (type: `integer`):

How many times to retry a failed HTTP request before giving up.

## `maxRequestsPerMinute` (type: `integer`):

Rate limit to avoid overloading target sites.

## `useProxy` (type: `boolean`):

Enable Apify Proxy for requests. Recommended for production runs on protected storefronts.

## Actor input object example

```json
{
  "productUrls": [
    {
      "url": "https://shop.polymer80.com/products/pf940v2-80-textured-pistol-frame"
    },
    {
      "url": "https://woocommerce.com/products/woocommerce-subscriptions/"
    }
  ],
  "previousSnapshot": {},
  "persistSnapshot": true,
  "maxRequestRetries": 3,
  "maxRequestsPerMinute": 30,
  "useProxy": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `report` (type: `string`):

No description

## `snapshot` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "productUrls": [
        {
            "url": "https://shop.polymer80.com/products/pf940v2-80-textured-pistol-frame"
        },
        {
            "url": "https://woocommerce.com/products/woocommerce-subscriptions/"
        }
    ],
    "previousSnapshot": {}
};

// Run the Actor and wait for it to finish
const run = await client.actor("mighty_monk/product-availability-monitor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "productUrls": [
        { "url": "https://shop.polymer80.com/products/pf940v2-80-textured-pistol-frame" },
        { "url": "https://woocommerce.com/products/woocommerce-subscriptions/" },
    ],
    "previousSnapshot": {},
}

# Run the Actor and wait for it to finish
run = client.actor("mighty_monk/product-availability-monitor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "productUrls": [
    {
      "url": "https://shop.polymer80.com/products/pf940v2-80-textured-pistol-frame"
    },
    {
      "url": "https://woocommerce.com/products/woocommerce-subscriptions/"
    }
  ],
  "previousSnapshot": {}
}' |
apify call mighty_monk/product-availability-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=mighty_monk/product-availability-monitor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/wwWOqlZJ84QJDezF6/builds/S5OzSUewJ0MMLW0EI/openapi.json