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 webhook

Edit scripts/watcher.js CONFIG section:

• webhookUrl: Your Clawdbot hooks URL (default: ) - webhookToken: Your hook token (find in clawdbot.json under hooks.token) ### 3. Test run __CODE_BLOCK_1__ First run seeds existing filings (no notifications). Second run checks for new filings. ### 4. Schedule (every 15 min) **macOS:** __CODE_BLOCK_2__ **Linux:** __CODE_BLOCK_3__ ## Managing Tickers Add or remove tickers in watchlist.json: __CODE_BLOCK_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:** __CODE_BLOCK_5__ **View logs:** __CODE_BLOCK_6__ **Stop:** __CODE_BLOCK_7__ **Start:** __CODE_BLOCK_8__ **Manual run:** __CODE_BLOCK_9__ ## 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)