edgartools

EdgarTools to zestaw umiejętności do pracy z dokumentami SEC — od wyszukiwania spółek i ich raportów, przez analizę sprawozdań finansowych, aż po dane o udziałowcach i transakcjach insiderów. Każda umiejętność zawiera gotowe wzorce i przykłady, a także listę pułapek, które warto znać. Dostęp do pełnej dokumentacji API bezpośrednio z obiektu — wystarczy .docs.

1. Zainstaluj EdgarTools i zaimportuj moduł edgar. Na początku każdej sesji ustaw swoją tożsamość za pomocą set_identity("Twoje Imię twoj@email.com") — jest to wymagane przez SEC.

2. Wyszukaj spółkę po tickerze, na przykład company = Company("AAPL"), lub znajdź konkretny raport po jego numerze dostępu filing = find("0000320193-25-000079"). Możesz też pobrać wszystkie raporty danego typu i roku: filings = get_filings(form="10-K", year=2024).

3. Zapoznaj się z dostępnym API każdego obiektu — wpisz company.docs lub filing.docs, aby zobaczyć pełny przewodnik. Jeśli szukasz konkretnej funkcji, użyj company.docs.search("filings") lub filing.docs.search("xbrl").

4. Wybierz umiejętność odpowiednią do Twoich potrzeb: core do wyszukiwania i podstawowych informacji, financials do sprawozdań finansowych, reports do sekcji raportów 10-K/10-Q/8-K, holdings do udziałów instytucjonalnych (13F) lub ownership do transakcji insiderów (Form 3/4/5).

5. Przejrzyj pliki skill.yaml w każdym katalogu umiejętności — zawierają wzorce i przykłady użycia. Zwróć uwagę na sharp-edges.yaml, gdzie opisane są częste błędy i jak ich unikać.

6. Zacznij od prostych zapytań — na przykład pobierz dane o spółce, a następnie jej ostatnie raporty — i stopniowo rozbudowuj skrypty o bardziej zaawansowaną analizę finansową lub XBRL.