DocsOpen app
Docs/Features/Watchers

Watchers

A Watcher is the unit of work in Prowlo: it tracks exactly one channel and decides what gets crawled into your Dataset. With no Watchers, Prowlo makes zero requests.

One channel per Watcher

Each Watcher tracks exactly one channel. The channel is the Watcher's identity — its name is derived from it (e.g. r/saas), and to watch another channel you create another Watcher. Supported channel types:

  • Subreddit — every new post in a community, checked hourly for active communities
  • Reddit user — a specific account's posts
  • Keyword search — one query searched across all of Reddit daily, managed on the Keyword Monitor page (see Keyword Monitor)
  • Hacker News — an HN search query
  • Mastodon — a Mastodon account
  • RSS — any feed URL
  • X (Twitter) — an X account, checked about twice a day (paid plans)

Prefilter rules

A Watcher can carry intake filters that decide which posts are worth indexing — anything that fails a filter is dropped before it reaches your Dataset. Common filters: minimum upvotes, language, post age, exclude reposts, exclude known promo accounts. See Intake filters & tagging rules for every field and operator.

Why prefilter?

High-volume communities produce noise. A prefilter keeps your Dataset — and your agent's context window — clean, so searches return signal instead of spam.

Keyword tagging rules

On top of intake filters, you can add keyword tagging rules — terms that tag matching records as they're ingested (matching is stemming-aware, so "deploy" also catches "deploying" and "deployment"). Tags let you filter your feed, searches, and Alerts to the terms you care about. Tagging rules are uncapped on every plan, and adding one backfills matches from the last 7 days of ingested posts. Full reference: Intake filters & tagging rules.

How crawling behaves

  • Cadence — active communities are checked roughly hourly on the paid plan; quiet ones back off. Trial organizations crawl about daily. Keyword-search channels are checked about once a day on every plan.
  • Instant fill — when you add a channel Prowlo already covers, matching records appear in your Dataset immediately, and a fresh crawl backfills the rest.
  • Stop at seen — each channel keeps a cursor of the newest post it has seen, so crawls pull only what's new.
  • No global crawl — Prowlo reads only your watched channels, through a residential-proxy stack, and never posts, comments, or votes.

Limits

The free trial includes 5 community Watchers; the paid plan includes 25. Keywords (the Keyword Monitor page) have their own separate quota (3 on trial, 20 paid) — they never consume Watcher slots. See Plans & limits for the full table.

Managing Watchers from your agent

Everything above works over MCP too. Once connected (see MCP Integration), your agent can call:

list_watchers                     — list Watchers and their channels
watcher_create                    — create a Watcher (one per source entry)
watcher_create + "reddit_search"  — add a keyword (searches all of Reddit)
watcher_update / watcher_delete   — edit or remove

Or just ask: "Add a Watcher for r/devops".