A threshold-based monitoring integration to watch Scrapfly account metrics and trigger notifications via webhooks, email, or in-app alerts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install scrapfly-alerting
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install scrapfly-alerting using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Scrapfly Alerting?
The Scrapfly Alerting integration for Openclaw Skills allows teams to monitor vital Scrapfly account metrics like scrape success rate, block rate, latency, and costs. By defining threshold-based rules, you can receive real-time notifications when your scraping pipelines experience disruptions. This skill unifies three major call paths: the REST API, MCP alert tools, and the Scrapfly CLI subcommand.
Using this skill within Openclaw Skills ensures that AI agents can inspect historical data baselines and validate alerts against real metrics before creating them. This helps prevent noisy configurations and guarantees that notifications are meaningful, actionable, and grounded in actual account behavior.
Scrapfly Alerting Use Cases
- Monitor scrape success rates and configure alerts to notify developers if the rate drops below acceptable thresholds.
- Detect sudden spikes in ASP block rates or scraper latencies for target domains.
- Track Scrapfly usage costs and error counts to prevent budget overruns.
- Automate incident response workflows by snoozing, unsnoozing, or testing alerts during maintenance cycles.
How Scrapfly Alerting Works
- Discover Baseline: Retrieve current performance aggregates to understand normal account or target domain behavior.
- Fetch Metric Registry: Query legal metric IDs and allowed dimensions from the Scrapfly Alerting registry.
- Preview Rules: Replay the proposed alert rule against historical telemetry data to assess noise levels and potential alerts.
- Create with Dry-Run: Perform an initial dry-run setup to receive a schema preview and verify parameters.
- Commit Alert: Finalize the creation with explicit confirmation to activate real-time tracking across email, webhooks, or in-app channels.
Scrapfly Alerting Setup
Prerequisites
- An Enterprise Scrapfly plan containing the ALERTING feature flag.
- A valid Scrapfly API key (e.g.,
scp-live-...).
CLI Configuration
You can configure the Scrapfly CLI to manage alerts directly using the following commands:
# Install the CLI if not already present
npm install -g @scrapfly/cli
# Set your API key
export SCRAPFLY_API_KEY="scp-live-your-key-here"
# Verify your metric families
scrapfly alert metric-families
Scrapfly Alerting Data Schema & Taxonomy
Alert State Matrix
| State | Description |
|---|---|
| ok | Normal operations; no thresholds are breached. |
| pending | A breach is observed but has not yet sustained for the required duration. |
| triggered | Breach duration sustained; notifications have fired. |
| recovering | Metrics are normal but waiting for the recovery period to clear. |
| no_data | The evaluation window contained zero data points. |
| snoozed | Explicitly muted by an operator. |
Notification Channels Schema
- email: Standard RFC 5322 address targeting.
- webhook: POST delivery with an HMAC-SHA256 signature in the
X-Scrapfly-Signatureheader. - inapp: Delivers notifications directly to the dashboard bell panel.
Scrapfly Alerting Advanced Features
- Dry-Run Validation: Previewing alert rules over historical windows prevents spamming notification targets.
- Webhook Security: Cryptographically sign alerts via per-alert HMAC-SHA256 signing keys.
- Multi-Interface Support: Interact seamlessly via REST requests, MCP tool declarations, or IaC-style JSON files through the CLI.
- Auto-Snoozing: Modifying an alert automatically silences noisy notifications during the sustained duration configuration.
SKILL.md
Loading
Related Openclaw Skills
Scrapfly Go SDK
An advanced web scraping SDK for Go that enables seamless proxy rotation, anti-bot bypass, JavaScript rendering, and automated data extraction.
Scrapfly Cloud Browser
Automate cloud browsers using the Scrapfly Cloud Browser API with Python Playwright for residential proxy rotation and anti-bot fingerprint management.
StablePay Agent Bootstrap
A dedicated setup skill to bootstrap, validate, and integrate the StablePay MCP server and CLI utility for AI coding agents.
kb_web_query
An intelligent Q&A skill that leverages team overview documents to guide and ground external web search queries.
Scrapfly TypeScript SDK
A TypeScript and JavaScript SDK for Scrapfly designed to handle complex web scraping, JavaScript rendering, anti-bot bypass, and AI-driven data extraction.
Scrapfly Extraction
An integration for extracting structured data from raw web content, text, or markdown using the Scrapfly Extraction API and AI-driven models.
Featured*
