Monitor a new page
add_sourceIdempotent
Start monitoring a web page for the user. One page per URL: if the account already monitors this URL — under any instructions — no second page is started. The settings this call carries are applied to the page that already exists instead, and the response says which case you got: created is true for a new page, false for one that was already monitored, where updatedSettings lists what this call changed on it. Each check spends one credit per page it reads — the source page, plus each item page it follows.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The page URL to monitor. | |
| userPrompt | No | Optional instructions for what changes matter. On a page already monitored this replaces its instructions; pass null to clear them. A changed prompt there re-learns how the page is read: one credit if the re-learn succeeds, skipped at zero balance (the prompt still saves). | |
| monitoringFrequency | No | Minutes between checks, from 30 to 10080; anything outside that range is refused rather than quietly changed. Checks run on a scheduler tick, so the cadence actually in effect can be slower than the one stored — read `effectiveMonitoringFrequency` from get_source or list_sources for it. Defaults to 60. | |
| notificationsEnabled | No | Whether to notify on changes (default false). |