Skills
Skill 8 of 13
Alert by webhook/email on web changes — use for “monitor/watch/track/alert me when”: recurring checks on known URLs (prefer over repeated one-off scrapes) or web-wide watches for…
2 minutes · 414 words · 3 sections
Install
npx skills add firecrawl/cli --skill firecrawl-monitornpx skills add firecrawl/cli/plugin marketplace add firecrawl/cliThe first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.
Detect when content on a website changes and get notified by webhook or email. Firecrawl handles fetching, diffing, judging, and notifying server-side. Each page in a check is labeled same, new, changed, removed, or error.
Pick a target mode by what you’re watching:
| Mode | Flags | Watches |
|---|---|---|
| Single page | --page <url> | one URL, for changes |
| URL batch | --scrape-urls <url,url,...> | several URLs, for changes |
| Whole site | --crawl-url <root-url> | every page a crawl discovers, for changes |
| Web search | --queries <q,...> + --goal | the whole web, for new results matching the goal |
The first three watch URLs you already have. runs your queries each check and alerts on results it hasn’t seen before (labeled once, on later checks); is required with .
newsame--goal--queries# Single page, natural-language schedule, email alert
firecrawl monitor create --name "Blog" --schedule "every 30 minutes" \
--goal "Alert when a new blog post is published." \
--page https://example.com/blog \
--email alerts@example.com
# Web monitor — search the whole web for NEW results matching a goal
firecrawl monitor create --name "Competitor launches" --schedule "daily at 9:00" \
--queries "competitor product launch,competitor funding round" \
--goal "Alert when a competitor announces a new product or raises funding." \
--search-window 7d --max-results 20 \
--email alerts@example.com
# Webhook notifications
firecrawl monitor create --name "Docs webhook" --schedule "every 30 minutes" \
--goal "Alert when docs content changes." \
--page https://example.com/docs \
--webhook-url https://example.com/hook \
--webhook-events monitor.page,monitor.check.completed
# Manage and inspect
firecrawl monitor list --limit 20
firecrawl monitor get <monitorId>
firecrawl monitor run <monitorId> # trigger a check now
firecrawl monitor checks <monitorId> # list all checks
firecrawl monitor check <monitorId> <checkId> --page-status changed
firecrawl monitor update <monitorId> --state paused
firecrawl monitor delete <monitorId>Subcommands: create | list | get | update | delete | run | checks | check. Run firecrawl monitor <subcommand> --help for the full option list.
Done when: create returns a monitor ID and a smoke-test run + check confirms the expected target, state, and notification configuration.
Read goals.md (opens in a new tab) when writing or refining --goal (and --queries for web monitors). Read json-tracking.md (opens in a new tab) when the user cares about specific structured fields (price, headline, stock flag) and wants per-field diffs.
update --state paused; reserve delete for monitors that are permanently done. (--state is an update flag; --status is the global CLI status flag.)--page-status changed (or new, removed, error) to skip the noise from same pages.firecrawl monitor run <id> triggers a check immediately — useful for smoke-testing a monitor right after creating it.--retention-days controls how long snapshots are kept for diffing. Lower it for high-frequency monitors to save storage.maxAge to 0 — every check performs a fresh scrape unless scrapeOptions.maxAge is set explicitly in a JSON payload.monitor when checks become recurring--crawl-url here for recurring crawl diffsAlert by webhook/email on web changes — use for "monitor/watch/track/alert me when": recurring checks on known URLs (prefer over repeated one-off scrapes) or web-wide watches for new results (queries + goal).
The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.
Bash(firecrawl *)Bash(npx firecrawl-cli *)skills/firecrawl-monitor/SKILL.mdmain, last pushed 23 September 2026.SKILL.md, not by matching a directory convention. One layout observed: skills/*/SKILL.md.h1 and no skipped levels:.claude-plugin/marketplace.json by Firecrawl, declaring 1 plugin. It is read for editorial metadata only — never as the skill index, which is always the repository tree./firecrawl/cli.md, and each skill at its own .md URL.2 files · 7 KB
Everything this skill ships beside its prose. All of it is set here, as subchapters of skill 8.
Everything else published alongside the skill.