Dla agentów AI i programistów

Dziennik Firm udostępnia dane o zmianach w polskich spółkach agentom AI i programistom: publicznie, tylko do odczytu, bez rejestracji i kluczy. To te same dane, które widać na stronach serwisu: karty spółek z historią wpisów w KRS, wydania dzienne, listy zdarzeń i teksty redakcji. Każda odpowiedź ma adres strony serwisu i datę.

Serwer MCP

Adres (Streamable HTTP, JSON-RPC 2.0, bez logowania i bez sesji): https://dziennikfirm.pl/mcp. Konfiguracja klienta:

{
    "mcpServers": {
        "dziennikfirm": {
            "type": "http",
            "url": "https://dziennikfirm.pl/mcp"
        }
    }
}

Narzędzia (publiczne tylko do odczytu; trzy ostatnie działają na liście obserwowanych spółek zalogowanego czytelnika – logowanie OAuth):

• search_companies – Szuka polskiej spółki w bazie Dziennika Firm po nazwie (min. 3 znaki), numerze KRS albo NIP: nazwa, forma prawna, KRS, NIP, REGON, siedziba, status w KRS, url karty. Baza obejmuje spółki z wpisami w KRS od 1 listopada 2026. Szczegóły i historia wpisów: get_company.
• get_company – Karta spółki po numerze KRS, jak na stronie Dziennika Firm: status, forma, NIP, REGON, siedziba, data wpisu, kapitał, przeważające PKD, organ reprezentujący (bez nazwisk), ostatnie sprawozdanie finansowe, „co wynika z rejestru” (fakty, bez ocen kondycji) i historia wpisów w KRS z rozpoznanymi zmianami (zarząd, siedziba, kapitał, likwidacja, upadłość…).
• get_daily_edition – Co zmieniło się w polskich spółkach danego dnia (Biuletyn KRS): liczba spółek z wpisami, liczby po rodzajach zmian (nowe spółki, likwidacje, upadłości, restrukturyzacje, wykreślenia, zmiany zarządów…) i pełne listy upadłości, restrukturyzacji i likwidacji. Bez daty: ostatnie zamknięte wydanie.
• list_editions – Wydania dzienne od najnowszego: data, stan (zamknięte albo w przygotowaniu), liczba spółek z wpisami, nowe spółki, likwidacje, upadłości, restrukturyzacje, wykreślenia, zmiany zarządów.
• list_events – Wpisy w KRS rozpoznane jako zdarzenia (np. nowe spółki, likwidacje, upadłości, zmiany zarządów) z filtrami: typ, dzień albo zakres dat, województwo; od najnowszych, ze stronicowaniem. Każda pozycja: data, rodzaj zmiany, spółka (nazwa, KRS, siedziba), url karty.
• list_event_types – Słownik filtrów: 23 rodzaje zdarzeń w KRS (typ, nazwa, url listy) i 16 województw (slug, url).
• search_articles – Opublikowane teksty Dziennika Firm (poradniki o obowiązkach spółek i sprawdzaniu kontrahenta, analizy, wydania): tytuł, dział, data, zajawka, url. Pełny tekst: url z nagłówkiem Accept: text/markdown.
• get_article – Jeden opublikowany tekst po slugu (z search_articles): tytuł, dział, daty, zajawka, spis treści. Pełny tekst: url z Accept: text/markdown.
• get_site_info – Fakty o Dzienniku Firm: wydawca (JG INVEST P.S.A.), redakcja, źródła danych i metodyka, zasady (bez danych osób fizycznych), liczba spółek w bazie, obserwowane spółki.
• list_my_watchlist – Wymaga zalogowania (OAuth, scope watchlist:read). Lista spółek obserwowanych przez zalogowanego czytelnika: nazwa, KRS, status w KRS, ostatni wpis, od kiedy obserwuje, url karty; czy powiadomienia e-mail są włączone.
• watch_company – Wymaga zalogowania (OAuth, scope watchlist:write). Dodaje spółkę z bazy Dziennika Firm do obserwowanych przez czytelnika (najwyżej 50). Po zamknięciu każdego wydania czytelnik dostaje e-mail z nowymi wpisami w KRS obserwowanych spółek. Używaj tylko na wyraźną prośbę czytelnika.
• unwatch_company – Wymaga zalogowania (OAuth, scope watchlist:write). Usuwa spółkę z obserwowanych przez czytelnika.

Obserwowane spółki przez agenta (OAuth 2.1)

Na swoim koncie możesz obserwować do 50 spółek: po zamknięciu wydania wyślemy Ci e-mail z ich nowymi wpisami w KRS. Agent może – za Twoją zgodą – pokazać tę listę, dodać do niej spółkę albo ją usunąć. Logujesz się linkiem z e-maila, bez hasła, i na ekranie zgody widzisz, kto prosi o dostęp i do czego. Dostęp odwołasz w każdej chwili na stronie konta albo Twoje połączone aplikacje.

• Klienci MCP (np. Claude, MCP Inspector) robią to sami: po odpowiedzi 401 znajdą serwer autoryzacji https://dziennikfirm.pl (metadane RFC 8414), zarejestrują się (RFC 7591) i otworzą okno logowania. PKCE S256, tokeny 1 h, refresh rotowany.
• Agenci bez przeglądarki: rejestracja według auth.md (service_auth z Twoim e-mailem, kod do wpisania na naszej stronie).
• Zakresy: watchlist:read (odczyt listy), watchlist:write (dodawanie i usuwanie spółek). Token działa tylko na https://dziennikfirm.pl/mcp.

REST API

Baza: https://dziennikfirm.pl/wp-json/dzf/v1. Opis OpenAPI 3.1: /wp-json/dzf/v1/openapi. Katalog API (RFC 9727): /.well-known/api-catalog.

Przykład: curl "https://dziennikfirm.pl/wp-json/dzf/v1/zdarzenia?typ=upadlosc&limit=10"

Strony w Markdown

Każda strona serwisu zwraca Markdown, gdy klient wyśle nagłówek Accept: text/markdown. Przeglądarki dostają HTML jak dotąd. Mapa serwisu dla modeli: /llms.txt, pełna treść tekstów: /llms-full.txt.

Odkrywanie

• Katalog zasobów AI (AI Catalog / ARD): /.well-known/ai-catalog.json
• Karta serwera MCP: /.well-known/mcp/server-card.json
• Skill dla agentów: /.well-known/agent-skills/index.json
• Uwierzytelnianie: /auth.md (potrzebne tylko do obserwowanych spółek)
• Narzędzia WebMCP w przeglądarce: szukanie spółki, karta spółki, wydanie dnia, zdarzenia.
• Rekordy DNS-AID: _mcp._agents.dziennikfirm.pl, _index._agents.dziennikfirm.pl (SVCB) i _catalog._agents.dziennikfirm.pl (TXT).
• Nagłówki Link na każdej stronie wskazują te same zasoby.

Zasady korzystania

• Limit: 60 zapytań na minutę z jednego adresu IP (REST i MCP razem). Po przekroczeniu HTTP 429 i nagłówek Retry-After.
• Cytowanie: linkuj do strony serwisu z pola url i podawaj datę (odczyt). Pole cytuj ma gotowy dopisek.
• Co znaczą dane: stan wpisów w rejestrze publicznym, bez ocen wiarygodności spółek i bez porad prawnych. Rodzaj zmiany rozpoznajemy po polach odpisu – źródła i metodyka. Błąd? Zgłoś korektę.
• Zakres bazy: spółki z wpisami w KRS od 1 listopada 2026. API i MCP nie pobierają spółek z rejestru na żądanie; kartę spółki spoza bazy pobierze jej strona /spolka/<krs>/.
• Prywatność: nie publikujemy danych osób fizycznych z rejestru. Publiczne API i narzędzia MCP nie przyjmują danych osobowych, niczego nie zapisują i nie potrzebują cookies ani logowania. Narzędzia obserwowanych spółek działają wyłącznie na koncie zalogowanego czytelnika (polityka prywatności).
• Prawa do treści: cytowanie z podaniem źródła i linku jest dozwolone. Preferencje wykorzystania treści przez systemy AI są w robots.txt.
• Status: /wp-json/dzf/v1/status. Kontakt: redakcja@dziennikfirm.pl.

English