How do I install the Sec Filing Watcher skill?

Run npx skillmds@latest add dvcrn/sec-filing-watcher in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Sec Filing Watcher safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sec Filing Watcher?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Sec Filing Watcher free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Sec Filing Watcher?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sec Filing Watcher by dvcrn — Agent Skill

Name: Sec Filing Watcher
Rating: 4.2 (5 reviews)
Author: dvcrn

Sec Filing Watcher

Monitor SEC EDGAR for new filings and get Telegram/Slack summaries via Clawdbot. Use when setting up SEC filing alerts, adding/removing tickers to monitor, configuring form types, starting/stopping the watcher, or troubleshooting filing notifications.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

SEC Filing Watcher

Monitors SEC EDGAR for new filings from a watchlist of tickers. When a new filing appears, notifies Clawdbot which fetches, summarizes, and sends to Telegram.

Quick Setup

1. Create watchlist

cp assets/watchlist.example.json watchlist.json
# Edit watchlist.json with your tickers

2. Configure environment

Set the following env vars (e.g. in your shell profile or OpenClaw skill config):

Variable	Required	Description
`OPENCLAW_HOOKS_TOKEN`	Yes	Your OpenClaw hooks token
`SEC_WATCHER_RECIPIENT`	Yes	Chat/user ID to deliver notifications to
`SEC_WATCHER_CHANNEL`	No	Channel plugin to deliver via (default: `telegram`)
`SEC_WATCHER_USER_AGENT`	No	SEC API User-Agent string (SEC requires contact info)

3. Test run

node scripts/watcher.js

First run seeds existing filings (no notifications). Second run checks for new filings.

4. Schedule (every 15 min)

macOS:

cp assets/com.sec-watcher.plist ~/Library/LaunchAgents/
# Edit the plist to set correct paths
launchctl load ~/Library/LaunchAgents/com.sec-watcher.plist

Linux:

crontab -e
# Add: */15 * * * * /usr/bin/node /path/to/scripts/watcher.js >> /path/to/watcher.log 2>&1

Managing Tickers

Add or remove tickers in watchlist.json:

{
  "tickers": ["AAPL", "MSFT", "TSLA"],
  "formTypes": ["10-K", "10-Q", "8-K", "4"]
}

New tickers are auto-seeded (existing filings won't spam you).

See references/form-types.md for common SEC form types.

Commands

Check status:

launchctl list | grep sec-watcher

View logs:

cat ~/clawd/sec-filing-watcher/watcher.log

Stop:

launchctl unload ~/Library/LaunchAgents/com.sec-watcher.plist

Start:

launchctl load ~/Library/LaunchAgents/com.sec-watcher.plist

Manual run:

node scripts/watcher.js

Files

File	Purpose
`scripts/watcher.js`	Main watcher script
`watchlist.json`	Your tickers and form types
`state.json`	Tracks seen filings (auto-created)
`watcher.log`	Output log (if configured)

Troubleshooting

No notifications:

Check state.json exists (first run seeds, second run notifies)
Verify webhook URL and token in watcher.js CONFIG
Check Clawdbot is running: clawdbot status

SEC blocking requests:

Script uses proper User-Agent header
If blocked, wait 10 minutes (SEC rate limit cooldown)

Duplicate notifications:

Check state.json isn't corrupted
Delete state.json to re-seed (will seed all existing filings again)

---name: sec-filing-watcherdescription: Monitor SEC EDGAR for new filings and get Telegram/Slack summaries via Clawdbot. Use when setting up SEC filing alerts, adding/removing tickers to monitor, configuring form types, starting/stopping the watcher, or troubleshooting filing notifications.---# SEC Filing WatcherMonitors SEC EDGAR for new filings from a watchlist of tickers. When a new filing appears, notifies Clawdbot which fetches, summarizes, and sends to Telegram.## Quick Setup### 1. Create watchlist```bashcp assets/watchlist.example.json watchlist.json# Edit watchlist.json with your tickers```### 2. Configure environmentSet the following env vars (e.g. in your shell profile or OpenClaw skill config):| Variable | Required | Description ||----------|----------|-------------|| `OPENCLAW_HOOKS_TOKEN` | **Yes** | Your OpenClaw hooks token || `SEC_WATCHER_RECIPIENT` | **Yes** | Chat/user ID to deliver notifications to || `SEC_WATCHER_CHANNEL` | No | Channel plugin to deliver via (default: `telegram`) || `SEC_WATCHER_USER_AGENT` | No | SEC API User-Agent string (SEC requires contact info) |### 3. Test run```bashnode scripts/watcher.js```First run seeds existing filings (no notifications). Second run checks for new filings.### 4. Schedule (every 15 min)**macOS:**```bashcp assets/com.sec-watcher.plist ~/Library/LaunchAgents/# Edit the plist to set correct pathslaunchctl load ~/Library/LaunchAgents/com.sec-watcher.plist```**Linux:**```bashcrontab -e# Add: */15 * * * * /usr/bin/node /path/to/scripts/watcher.js >> /path/to/watcher.log 2>&1```## Managing TickersAdd or remove tickers in `watchlist.json`:```json{ "tickers": ["AAPL", "MSFT", "TSLA"], "formTypes": ["10-K", "10-Q", "8-K", "4"]}```New tickers are auto-seeded (existing filings won't spam you).See `references/form-types.md` for common SEC form types.## Commands**Check status:**```bashlaunchctl list | grep sec-watcher```**View logs:**```bashcat ~/clawd/sec-filing-watcher/watcher.log```**Stop:**```bashlaunchctl unload ~/Library/LaunchAgents/com.sec-watcher.plist```**Start:**```bashlaunchctl load ~/Library/LaunchAgents/com.sec-watcher.plist```**Manual run:**```bashnode scripts/watcher.js```## Files| File | Purpose ||------|---------|| `scripts/watcher.js` | Main watcher script || `watchlist.json` | Your tickers and form types || `state.json` | Tracks seen filings (auto-created) || `watcher.log` | Output log (if configured) |## Troubleshooting**No notifications:**- Check `state.json` exists (first run seeds, second run notifies)- Verify webhook URL and token in watcher.js CONFIG- Check Clawdbot is running: `clawdbot status`**SEC blocking requests:**- Script uses proper User-Agent header- If blocked, wait 10 minutes (SEC rate limit cooldown)**Duplicate notifications:**- Check `state.json` isn't corrupted- Delete `state.json` to re-seed (will seed all existing filings again)

Frequently asked questions