Track a page and let people follow it (preview)
create_public_trackerCreates a monitor and returns a public-sharing preview so you can review and approve details before publishing a public tracker.
Instructions
Step 1 of 2 for "track X and let people subscribe" (needs an API key with the write and network:publish scopes): creates the monitor (as create_monitor does: plan limits apply, the first check starts now) and returns exactly what would become public on Monity Network (preview.shares, preview.doesNotShare), whether it can be public, public trackers of the same page (samePage), and a revisionId. Nothing is public yet: show the person the preview, get their agreement, then call publish_tracker with monitorUuid and revisionId. Call find_existing_network_watch first: if a public tracker already checks this page the same way, follow it instead.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"websiteUrl": "<websiteUrl>"
},
"name": "create_public_tracker"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Monitor name (defaults to the URL host/path); also the public title unless title is given | |
| scope | No | What exactly it covers, e.g. "UK store, size 10" | |
| title | No | Public title (default: the monitor name) | |
| category | No | A topic, e.g. deals, tickets, tech, jobs | |
| keywords | No | TEXT monitors only: comma-separated keywords to look for | |
| selector | No | CSS selector of ONE element to check instead of the whole page, e.g. '.product-price' | |
| frequency | No | Minutes between checks, as a string: '60' (hourly), '1440' (daily)… Omit for the plan default | |
| notifyWhen | No | The alert condition in words, e.g. 'when it is back in stock' | |
| websiteUrl | Yes | Absolute http(s) URL of the public page to track | |
| compareType | No | Comparison mode (default AUTO) | |
| description | No | Why it is worth following | |
| workspaceId | No | Workspace for the monitor (from list_workspaces); defaults to the key owner's personal workspace | |
| keywordsAction | No | TEXT monitors only: alert when keywords are ADDED (default) or REMOVED |