sec-filing-watcher

What This Skill Does

The sec-filing-watcher is an automation utility designed to keep you updated on corporate financial disclosures in real-time. By monitoring the SEC EDGAR database, it tracks your specific watchlist of company tickers and their associated form types (such as 10-K, 10-Q, or 8-K). When a new filing is published, the skill triggers a notification through Clawdbot, which fetches the document, generates a concise summary, and delivers it directly to your chosen communication channel, such as Telegram or Slack. This removes the need for manual site checks, ensuring you remain informed about critical market events immediately.

Installation

To begin, ensure you have the OpenClaw environment ready. First, install the skill using: clawhub install openclaw/skills/skills/in-liberty420/sec-filing-watcher. Next, prepare your watchlist by copying assets/watchlist.example.json to watchlist.json and populating it with your target tickers. Configure the required environment variables: OPENCLAW_HOOKS_TOKEN for authentication and SEC_WATCHER_RECIPIENT for notification delivery. If you are on macOS, install the provided launch agent via launchctl to enable background automation. For Linux users, a simple crontab entry running every 15 minutes is recommended to maintain the polling frequency. Always verify your setup with a manual run of node scripts/watcher.js to ensure the seeding process completes successfully.

Use Cases

• Investor Relations: Receive instant alerts when a company you own or track files their quarterly or annual reports.
• Market Analysis: Monitor competitors' 8-K filings to catch material developments, earnings announcements, or changes in corporate structure.
• Automated Research: Build a local archive of summarized SEC filings without spending time browsing the EDGAR portal manually.
• Alert Management: Dynamically add or remove tickers from your watch list as your investment thesis changes.

Example Prompts

1. "OpenClaw, add TSLA and NVDA to my sec-filing-watcher list and set the notifications to my Telegram channel."
2. "Check the status of my sec-filing-watcher; are there any errors in the current log file?"
3. "OpenClaw, stop the SEC filing watcher for now because I need to update my form type preferences in the watchlist.json file."

Tips & Limitations

• Rate Limiting: The SEC restricts automated access. Always ensure your SEC_WATCHER_USER_AGENT includes valid contact information to prevent your IP from being blocked.
• Seeding: The first time you run the script, it will create a state.json file to store existing filings. You will not receive notifications for past filings, only for new ones published after the initial seeding.
• Persistence: If you encounter unexpected duplicate notifications, delete state.json to force a clean re-seeding process.
• Logs: Regularly inspect watcher.log to troubleshoot connectivity issues or failed webhook delivery to Clawdbot.