# skanfirmy.pl

> Bezpłatne narzędzia do weryfikacji polskich firm po numerze NIP, KRS lub PESEL.
> Dane pobierane bezpośrednio z oficjalnych rejestrów rządowych (Ministerstwo
> Finansów, Ministerstwo Sprawiedliwości, GUS), bez logowania, bez opłat, bez
> zapisywania danych na serwerze — wszystko liczone lub pobierane lokalnie w
> przeglądarce użytkownika.

## Narzędzia

- [Biała Lista VAT](https://skanfirmy.pl/vat): sprawdź status VAT (czynny/zwolniony) i rachunki bankowe podmiotu po NIP, wprost z Wykazu Podatników VAT (Ministerstwo Finansów).
- [Dane z KRS](https://skanfirmy.pl/krs): forma prawna, PKD, kapitał zakładowy, adres i reprezentacja firmy po NIP lub numerze KRS (Krajowy Rejestr Sądowy).
- [Weryfikacja rachunku](https://skanfirmy.pl/rachunek): sprawdź, czy numer rachunku bankowego figuruje w Wykazie VAT dla danego NIP — należyta staranność przy przelewach powyżej 15 000 zł.
- [Mikrorachunek podatkowy](https://skanfirmy.pl/mikrorachunek): wygeneruj indywidualny rachunek do wpłat PIT/CIT/VAT na podstawie NIP lub PESEL, wyliczany lokalnie w przeglądarce.
- [Kody PKD 2025](https://skanfirmy.pl/pkd): wyszukiwarka pełnej listy 728 podklas klasyfikacji PKD 2025 (GUS), po nazwie działalności lub numerze kodu.
- [Kalkulator odsetek za opóźnienie](https://skanfirmy.pl/odsetki): oblicz odsetki ustawowe lub za transakcje handlowe (B2B) na podstawie aktualnych stóp referencyjnych NBP.
- [VIES — unijny numer VAT](https://skanfirmy.pl/vies): sprawdź ważność numeru VAT kontrahenta z innego kraju UE w systemie VIES Komisji Europejskiej.

## Endpointy dla agentów

`GET https://skanfirmy.pl/nip/{10-cyfrowy-NIP}` — zwraca dane firmy (Wykaz VAT MF,
i odpis KRS jeśli podmiot go ma) jako czysty, fetchowalny HTML z widocznym tekstem
i osadzonym JSON-LD (schema.org Organization). Nie wymaga wypełniania formularza ani
wykonywania JS. Dodaj `?format=json` dla surowej odpowiedzi JSON zamiast HTML.
Przykład: `https://skanfirmy.pl/nip/7393933151?format=json`.

`GET https://skanfirmy.pl/vies/{kod-kraju-UE}/{numer-VAT}` — to samo dla unijnego
VAT przez VIES (Komisja Europejska). Kod kraju: dwuliterowy (np. `DE`, `IE`, `FR`),
numer VAT bez prefiksu kraju. Też wspiera `?format=json`.
Przykład: `https://skanfirmy.pl/vies/IE/6388047V?format=json`.

Pozostałe pięć narzędzi (Biała Lista VAT, KRS, rachunek, mikrorachunek, PKD) działają
w interaktywnym interfejsie w całości po stronie klienta (w przeglądarce) — `/nip/{numer}`
i `/vies/{kraj}/{numer}` to jedyne miejsca z komponentem serwerowym w samym interfejsie
strony. Wszystkie siedem narzędzi jest też dostępnych jako narzędzia MCP, patrz niżej.

## Serwer MCP (Model Context Protocol)

`POST https://skanfirmy.pl/mcp` — pełny serwer MCP (transport Streamable HTTP,
bezstanowy, zgodny ze spec 2025-06-18+) do bezpośredniego wywoływania jako tool
przez agentów obsługujących MCP (Claude i inni), zamiast czytania stron HTML.
Bez autoryzacji, bez opłat. Standardowe metody JSON-RPC 2.0: `initialize`,
`tools/list`, `tools/call`.

Dostępnych 7 narzędzi (pierwszych 6 pokrywa wszystkie 7 funkcji strony —
sprawdzenie NIP łączy Białą Listę VAT i KRS w jednym wywołaniu; siódme
przeszukuje osobny katalog innych publicznych API):

- `sprawdz_nip` — status VAT + dane z KRS po numerze NIP
- `sprawdz_vies` — ważność unijnego numeru VAT przez VIES
- `sprawdz_rachunek` — czy rachunek bankowy jest na Białej Liście dla danego NIP
- `generuj_mikrorachunek` — mikrorachunek podatkowy z NIP lub PESEL
- `szukaj_pkd` — wyszukiwarka kodów PKD 2025 po nazwie lub numerze
- `oblicz_odsetki` — kalkulator odsetek ustawowych i handlowych (B2B)
- `szukaj_katalog_api` — przeszukuje [otwarteAPI.pl](https://otwarteapi.pl) (katalog innych publicznych API Polski i UE) na żywo

Przykład wywołania (`tools/call`):
```json
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"sprawdz_nip","arguments":{"nip":"7393933151"}}}
```

## Inne

- [Polityka prywatności](https://skanfirmy.pl/privacy)
- Zobacz też: [otwarteAPI.pl](https://otwarteapi.pl) — katalog polskich publicznych API i rejestrów rządowych (zgodny ze specyfikacją `ai-catalog.json`), skanfirmy.pl jest w nim wpisem flagowym.