A real-time monitoring tool for SEC EDGAR filings that delivers summarized financial alerts via Telegram or Slack.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sec-filing-watcher
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 sec-filing-watcher 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 SEC Filing Watcher?
The SEC Filing Watcher is a specialized utility designed for investors, analysts, and developers to track specific corporate filings in real-time. By leveraging Openclaw Skills, this agent monitors the SEC EDGAR database for specific tickers and form types, ensuring you never miss a critical 10-K, 10-Q, or 8-K.
This skill integrates seamlessly with Clawdbot to fetch, process, and summarize complex filings into digestible notifications. It is built to handle the technical requirements of the SEC API, including rate limiting and user-agent string management, providing a robust solution for financial data monitoring.
SEC Filing Watcher Use Cases
- Tracking real-time earnings reports (10-Q/10-K) for a specific portfolio of stocks.
- Receiving instant alerts for material corporate events or insider trading activity via 8-K and Form 4 filings.
- Automating financial research workflows by piping summaries directly into team communication channels like Slack or Telegram.
- Maintaining a low-latency watch on competitor filings without manual EDGAR searches.
How SEC Filing Watcher Works
- The watcher script initializes by reading the watchlist.json file to identify target tickers and form types.
- On the first execution, the system seeds the current state by recording existing filings in state.json without sending notifications.
- Subsequent scheduled runs compare the live EDGAR feed against the recorded state to detect new submissions.
- When a match is found, the skill triggers a webhook through Openclaw Skills to Clawdbot.
- Clawdbot fetches the full filing, generates a summary, and delivers it to the configured recipient via Telegram or Slack.
SEC Filing Watcher Setup
To deploy this skill, first prepare your watchlist and environment variables:
cp assets/watchlist.example.json watchlist.json
# Edit watchlist.json with your desired tickers
Configure the required environment variables to enable communication within the ecosystem:
| Variable | Required | Description |
|---|---|---|
| OPENCLAW_HOOKS_TOKEN | Yes | Your Openclaw Skills hooks token |
| SEC_WATCHER_RECIPIENT | Yes | Chat/user ID for notifications |
| SEC_WATCHER_USER_AGENT | No | SEC API User-Agent contact info |
Finally, schedule the script to run every 15 minutes using Crontab (Linux) or LaunchAgents (macOS) to ensure continuous monitoring.
SEC Filing Watcher Data Schema & Taxonomy
The skill maintains local state and configuration files to ensure reliability and prevent duplicate alerts:
| File | Description |
|---|---|
watchlist.json |
JSON configuration of tickers and form types to monitor. |
state.json |
A local database tracking previously processed filing IDs to prevent duplicates. |
watcher.log |
Persistent log file capturing execution history and errors. |
scripts/watcher.js |
The core logic for API interaction and diff detection. |
SEC Filing Watcher Advanced Features
- Customizable form filtering allowing users to target specific SEC document types like Form 4 (Insider Trading) or 13F (Institutional Holdings).
- Automatic rate-limit handling and SEC-compliant headers to prevent IP blocking.
- Multi-channel notification support via the Openclaw Skills hook system, compatible with both Telegram and Slack.
- Silent seeding logic that prevents notification spam during initial setup or when adding new tickers to an existing watchlist.
SKILL.md
Loading
Related Openclaw Skills
Kraken Pro
A comprehensive CLI tool for managing Kraken exchange portfolios, trading execution, and staking operations.
1Password CLI (Hardened)
A secure integration for AI agents to access 1Password secrets using hardened service account workflows.
0G Compute Network
Access a decentralized AI inference marketplace with TEE-verified model integrity and on-chain billing.
Codex Autopilot
An automated multi-project orchestration system for Codex CLI using tmux and launchd on macOS.
Solana Easy Swap
A specialized skill for AI agents to perform seamless token swaps on the Solana blockchain using the Jupiter aggregator.
Security Joes AI Analyst
A specialized SecOps analyst for Windows endpoints that monitors EDR health, audits privileges, and validates system integrity.
METADATA
Featured*
