sec-filing-watcher

Automatycznie śledź nowe dokumenty finansowe z SEC EDGAR dla wybranych spółek. Skill integruje się z Clawdbot, aby pobierać, streszczać i wysyłać powiadomienia o nowych zgłoszeniach (10-K, 10-Q, 8-K, 4 i inne) bezpośrednio na Twój kanał Telegram lub Slack. Skonfiguruj listę akcji do monitorowania, wybierz typy formularzy, a następnie uruchom watcher, który będzie sprawdzać SEC co 15 minut. Idealne dla inwestorów, analityków i osób śledzących zmiany w portfelu spółek.

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.