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.

1. Przygotuj plik watchlist.json, kopiując szablon z assets/watchlist.example.json. Otwórz plik i wpisz symbole akcji, które chcesz monitorować (np. AAPL, MSFT, TSLA), oraz wybierz typy formularzy SEC (10-K, 10-Q, 8-K, 4). Nowe symbole zostaną automatycznie zsynchronizowane bez wysyłania powiadomień o starych zgłoszeniach.
2. Skonfiguruj zmienne środowiskowe wymagane do działania: OPENCLAW_HOOKS_TOKEN (token dostępu do OpenClaw), SEC_WATCHER_RECIPIENT (ID czatu lub użytkownika, do którego wysyłać powiadomienia), SEC_WATCHER_CHANNEL (opcjonalnie, domyślnie telegram) oraz SEC_WATCHER_USER_AGENT (opcjonalnie, wymagane przez SEC API).
3. Uruchom test watcher.js poleceniem node scripts/watcher.js. Pierwszy przebieg zainicjuje istniejące zgłoszenia bez wysyłania alertów. Drugi przebieg sprawdzi nowe dokumenty i wyśle powiadomienia.
4. Zaplanuj automatyczne sprawdzanie co 15 minut. Na macOS skopiuj plik com.sec-watcher.plist do ~/Library/LaunchAgents/, edytuj ścieżki i załaduj za pomocą launchctl. Na Linuxie dodaj wpis do crontaba: */15 * * * * /usr/bin/node /ścieżka/do/scripts/watcher.js.
5. Zarządzaj monitorowanymi akcjami, edytując watchlist.json w dowolnym momencie. Dodaj lub usuń symbole, zmień typy formularzy. Zmiany wejdą w życie przy następnym uruchomieniu watchera.
6. Sprawdzaj status usługi poleceniem launchctl list | grep sec-watcher (macOS) lub przeglądając logi watcher.log (Linux), aby upewnić się, że monitorowanie działa prawidłowo.