How do I install the Sec Filing Watcher skill?

Run npx skillmds@latest add modbender/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?

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

Sec Filing Watcher by modbender — Agent Skill

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

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.

modbender Updated Sep 9, 2026 12 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 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 ```bash 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 ```bash node scripts/watcher.js ``` First run seeds existing filings (no notifications). Second run checks for new filings. ### 4. Schedule (every 15 min) **macOS:** ```bash cp assets/com.sec-watcher.plist ~/Library/LaunchAgents/ # Edit the plist to set correct paths launchctl load ~/Library/LaunchAgents/com.sec-watcher.plist ``` **Linux:** ```bash 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`: ```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:** ```bash launchctl list | grep sec-watcher ``` **View logs:** ```bash cat ~/clawd/sec-filing-watcher/watcher.log ``` **Stop:** ```bash launchctl unload ~/Library/LaunchAgents/com.sec-watcher.plist ``` **Start:** ```bash launchctl load ~/Library/LaunchAgents/com.sec-watcher.plist ``` **Manual run:** ```bash 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)

Frequently asked questions