Automatyzacja · Analiza konkurencji · Python

Radar Rynku: analiza konkurencji ze sprawozdań w KRS

Raz w roku automat zbiera sprawozdania finansowe konkurentów i odbiorców, sprawdza je, liczy wskaźniki i układa ranking, w którym własna firma jest zawsze punktem odniesienia. Każda liczba w raporcie ma przypis do sprawozdania, a każdy cytat z zarządu numer strony.

Klient
RAN-SIGMA Sp. z o.o.
Branża
Gospodarka odpadami
Rok
2026
Narzędzie
Python na serwerze firmy, Claude API do cytatów
Status
Wdrożone · pierwsze wydanie 30.10.2026

Wyzwanie

Zastrzeżenie: RAN-SIGMA to firma, którą zarządzam. Ten automat powstał na jej potrzeby i pierwszy raport wydał 30 października 2026 — tak samo testuję każde rozwiązanie, zanim zaproponuję podobne klientowi.

Sprawozdania finansowe spółek z KRS są jawne i bezpłatne, ale rozproszone. Każde trzeba pobrać osobno, przychodzą w kilku opakowaniach (goły XML, plik podpisany elektronicznie, archiwum ZIP), w różnych wersjach schematu, a grupy kapitałowe i spółki zagraniczne publikują je inaczej niż pojedyncze spółki. Ręczne zestawienie konkurencji na tle własnych wyników łatwo zrobić niekonsekwentnie: inna kolumna, inny kurs waluty, zero wpisane tam, gdzie danych po prostu nie było.

Wcześniej analizę konkurencji prowadził moduł w CRM firmy. Po uruchomieniu automatu jego dane wyeksportowano do archiwum, a moduł wyłączono.

Jak działa automat

Zasada: liczby i zdania raportu powstają z reguł, model językowy tylko wskazuje i streszcza cytaty. Ten sam wzorzec — dane bez przepisywania, kontrola przed liczeniem, raport i mail z podsumowaniem — stoi za automatem wyników finansowych i raportem spalania floty tej samej firmy.

Roczny kalendarz sprawozdań

1 lipca przychodzi prośba o przegląd listy spółek z podpowiedziami z rejestru. Od 30 lipca automat co poniedziałek, aż do skutku, pyta API KRS, kto już złożył sprawozdanie, i wysyła listę „do pobrania” z linkami. 30 września ma wyjść pierwsze wydanie raportu za poprzedni rok, a każde późniejsze sprawozdanie albo korekta daje nową wersję z tabelą zmian.

Człowiek pobiera, automat sprawdza

Repozytorium Dokumentów Finansowych nie ma API i chroni się przed robotami, więc pliki pobiera człowiek i wrzuca do folderu na Dysku. Automat rozpoznaje plik po treści, nie po nazwie, pomija duplikaty (także ten sam dokument w innym opakowaniu podpisu) i odkłada go do archiwum spółki i roku.

Plik z zewnątrz jest niezaufany

XML czyta bezpieczny parser bez definicji DTD i zewnętrznych encji. Rozmiar, zagnieżdżenie archiwów i stopień kompresji ZIP są sprawdzane przed rozpakowaniem, a nic z archiwum nie trafia na dysk serwera. Plik odrzucony zostaje w folderze, a automat wysyła jeden mail z kodem powodu.

Każda liczba z przypisem

Pozycje sprawozdania są mapowane po nazwach sekcji, kwoty liczone dokładnie, bez zaokrągleń w trakcie. Brak danych to „n/d”, nigdy zero. Bilans, który się nie bilansuje, jest odrzucany, a osobliwości źródła, np. wydatki inwestycyjne wpisane ze znakiem minus, są poprawiane jawnie, z flagą w danych. W raporcie każda liczba ma przypis do sprawozdania albo do obliczenia automatu, a aneks zawiera rejestr źródeł.

Grupy, spółki i zagranica

Porównanie ma dwa poziomy: grupa kapitałowa według sprawozdania skonsolidowanego i każda spółka osobno, a skład grupy zatwierdza człowiek. Rejestr zagraniczny z otwartym API (XBRL) automat czyta sam, pozostałe sprawozdania zagraniczne trafiają do wpisów ręcznych ze stroną źródła. Waluty przelicza jeden kurs NBP z dnia bilansowego, z przypisem w raporcie.

Ranking z własną firmą jako punktem odniesienia

Wskaźniki porównuje się w jednym, ustalonym zbiorze firm, a kierunek „lepiej” jest ustalony z góry (np. przy zadłużeniu niżej znaczy lepiej). Remis pokazuje wszystkie jednostki, nigdy jedną wybraną. Na wykresach własna firma jest w zieleni, reszta na szaro, mediana konkurencji to kreska, a luka w danych to przerwa w linii.

Cytaty z zarządów sprawdzane w źródle

Claude czyta sprawozdania z działalności i wskazuje dosłowne fragmenty o inwestycjach, planach, mocach, zatrudnieniu i ryzykach, każdy z numerem strony. Fragment trafia do raportu tylko wtedy, gdy automat znajdzie go na tej stronie. Przed wysłaniem tekstu do API imiona i nazwiska są zamieniane na funkcje. Krótkie streszczenia oznaczone „AI” powstają wyłącznie z przepuszczonych cytatów, a streszczenie z liczbą spoza nich jest odrzucane.

Wersje zamiast nadpisywania

Raportu nikt nie nadpisuje: korekta sprawozdania daje kolejną wersję (v2, v3…) z tabelą zmian wskaźników, a poprzednia zostaje. Dwa uruchomienia na tych samych danych dają bajtowo ten sam PDF i nie wysyłają drugiego maila. Mail wydania ma trzy kafle z wynikami własnej firmy i przyciski do dokumentów na Dysku, szczegóły są w załącznikach.

Co rozstrzyga automat, a co człowiek

Automat: kontrola, arytmetyka, forma

Automat sprawdza statusy w KRS, przyjmuje i waliduje pliki, liczy wskaźniki, układa ranking i wykresy, składa zdania raportu z szablonów i pilnuje wersji. Ramka „Wnioski (reguły)” porównuje własną firmę z medianą konkurencji według ustalonych kierunków. To zestawienie, nie ocena strategii.

Człowiek: lista, składy grup, interpretacja

Zarząd decyduje, kto jest konkurentem, a kto odbiorcą, zatwierdza skład grup kapitałowych, pobiera pliki z repozytorium i wpisuje liczby ze sprawozdań zagranicznych, których nie da się odczytać automatycznie. Odbiorcy mają osobny dokument „Radar Odbiorców”, więc nie mieszają się z rankingiem konkurencji. Wnioski z raportu wyciąga zarząd.

Gdzie pracuje AI, a gdzie nie

Model językowy robi tu dwie rzeczy: wskazuje w sprawozdaniach zarządów dosłowne fragmenty ze stroną, a ze sprawdzonych fragmentów pisze krótkie streszczenia oznaczone „AI”. Liczby, ranking i pozostałe zdania raportu powstają bez niego, a wyłącznik daje raport w pełni deterministyczny z adnotacją „bez analizy tekstu”. Przed włączeniem cytatów prezes zarządu spółki zatwierdził test równowagi interesów z RODO (29.10.2026). Rdzeń ma 189 testów automatycznych (stan na 4.11.2026). Wśród nich jest porównanie odczytu własnego sprawozdania z jego wizualizacją z portalu e-sprawozdań co do grosza oraz celowo zepsute kopie sprawozdań, które automat musi odrzucić albo oflagować. Obliczenia przypominają te z paneli analitycznych, ale wynikiem jest dokument dla zarządu, nie ekran.

Jak wygląda wynik

Prawdziwych raportów spółki nie publikujemy. Poniżej są strony raportu wygenerowane tym samym kodem na fikcyjnych danych testowych: firmy i liczby są zmyślone, a układ, obliczenia, przypisy i reguły pochodzą z działającego automatu.

Historia wdrożenia: 28 października – 4 listopada 2026

  • 28.10.2026: kontrakt techniczny i dane wzorcowe, odczyt sprawozdań XML, walidacja, wskaźniki, połączenia z KRS, NBP i rejestrem zagranicznym, wpisy ręczne.
  • 29.10.2026: liczby z XBRL, raport roczny, dokument o odbiorcach, maile i arkusz sterujący.
  • 30.10.2026: cytaty ze sprawozdań zarządów ze strażnikiem i redakcją danych osobowych, automat na serwerze firmy i pierwsze wydanie raportu za 2025 rok.
  • 31.10.2026: dane modułu analizy konkurencji w CRM wyeksportowane do archiwum, moduł wyłączony.
  • 1–4.11.2026: streszczenia AI, układ „narracja z przypisami”, tabela zmian w wersjach, rozdział o organizacjach odzysku olejów i więcej wykresów.

Wynik od października 2026

Raport za 2025 rok wyszedł 30.10.2026 w wersji pierwszej. Ponowne uruchomienie na tych samych danych dało wynik „bez zmian”: bez nowej wersji i bez drugiego maila. Zarząd dostaje jeden dokument o konkurencji i jeden o odbiorcach, a każde zdanie z liczbą da się sprawdzić w przypisie.

30.09
coroczny termin wydania I, po sprawozdaniach skonsolidowanych (za 2025: 30.10.2026, pierwszy rok automatu)
co tydzień
od 30 lipca sprawdzanie w KRS, kto złożył sprawozdanie
v2, v3…
korekta sprawozdania to nowa wersja raportu z tabelą zmian, nigdy nadpisanie

Co daje automat

  • Pilnowanie, kto już złożył sprawozdanie — automat sprawdza KRS co poniedziałek do skutku i wysyła listę z linkami
  • Liczby z przypisami — każda liczba w raporcie prowadzi do sprawozdania albo do obliczenia
  • Fragmenty sprawozdań zarządów — z numerem strony, sprawdzone w źródle
  • Jedno miejsce zamiast modułu w CRM — dane starego modułu wyeksportowane do archiwum, moduł wyłączony

Co dziś zrobiłbym inaczej

Od początku dałbym modelowi kolejność tematów dla każdej roli spółki. Pierwsze cytaty ze sprawozdania jednego z odbiorców dotyczyły jego innych linii produkcji, a nie przerobu olejów przepracowanych. Pomógł dopiero dopisek w poleceniu dla odbiorców: najpierw fragmenty o olejach, inne obszary tylko wtedy, gdy takich fragmentów brak.

Kiedy takie rozwiązanie nie ma sensu

Gdy konkurentów jest kilku i wszyscy składają proste sprawozdania w KRS, wystarczy raz w roku przejrzeć je ręcznie albo skorzystać z płatnej bazy danych finansowych. Radar nie powie też nic o bieżącym kwartale: sprawozdania roczne trafiają do KRS kilka miesięcy po końcu roku. Podmioty, które nie składają sprawozdań w KRS, np. jednoosobowe działalności gospodarcze, są dla automatu niewidoczne.

Czego tu nie ma

Na tej stronie nie ma prawdziwych nazw konkurentów i odbiorców, liczb z raportów spółki ani ocen. Pokazujemy mechanizm, bo to on jest przenośny między firmami. Raporty Radaru zostają w folderze zarządu RAN-SIGMA.

Pytania i odpowiedzi

Pytania o ten projekt

Skąd automat bierze sprawozdania?

Z KRS: API rejestru mówi, czy spółka złożyła sprawozdanie, a same pliki pobiera człowiek z Repozytorium Dokumentów Finansowych, które nie ma API, i wrzuca je do folderu na Dysku. Sprawozdania z rejestru zagranicznego z otwartym API automat pobiera sam, pozostałe zagraniczne trafiają do wpisów ręcznych ze stroną źródła.

Czy można ufać liczbom w raporcie?

Każda liczba ma przypis do sprawozdania albo do obliczenia automatu, a brak danych jest oznaczony „n/d”, nigdy zerem. Bilans, który się nie bilansuje, jest odrzucany. Odczyt sprawdzają testy na prawdziwych sprawozdaniach w różnych schematach i na celowo zepsutych kopiach, a dwa uruchomienia na tych samych danych dają identyczny PDF.

Co w tym projekcie robi AI?

Dwie ograniczone rzeczy: Claude wskazuje w sprawozdaniach zarządów dosłowne fragmenty o inwestycjach, planach, mocach, zatrudnieniu i ryzykach, ze stroną, a z fragmentów, które przeszły kontrolę, pisze krótkie streszczenia oznaczone „AI”. Automat sprawdza, czy każdy fragment naprawdę jest na tej stronie. Liczb, rankingu ani pozostałych zdań raportu model nie tworzy.

Co z danymi osobowymi z KRS?

Odpisy z KRS zawierają imiona, nazwiska i daty urodzenia członków organów. Automat odrzuca je w chwili odczytu i zostawia tylko funkcje, np. prezes zarządu. Przed wysłaniem tekstu sprawozdania do API imiona i nazwiska są zamieniane na funkcje, a logi zawierają nazwę pliku, skrót i kod błędu, nigdy treść.

Co się dzieje, gdy spółka złoży korektę sprawozdania?

Powstaje nowa wersja raportu z tabelą zmian wskaźników, a poprzednia zostaje bez zmian. Mail o nowej wersji wymienia, co się zmieniło. Raportu nigdy się nie nadpisuje.

Gdzie działa automat i kto widzi raporty?

Na serwerze firmy, na osobnym koncie systemowym, w rocznym cyklu: przegląd listy w lipcu, sprawdzanie KRS od końca lipca do skutku i codzienne skanowanie folderu od lipca do października. Raporty trafiają wyłącznie do folderu zarządu na Dysku firmy. Przed zapisem automat sprawdza uprawnienia folderu i nie zapisze raportu, jeśli folder jest udostępniony przez link albo całej domenie.

Konkurencję śledzisz z wydruków sprawozdań?

Na pierwszej rozmowie sprawdzamy, które firmy z Waszej listy składają sprawozdania w KRS, w jakiej formie i co z nich da się uczciwie porównać z Waszymi wynikami.

Szczegóły projektu

Technologie

Python · defusedxml · openpyxl · reportlab · matplotlib · API KRS · Claude API · Google Drive API · systemd

Zakres prac