Integracje

Gotowe wtyczki do sklepów, widget do dowolnego formularza, serwer MCP dla asystentów AI i monitoring zmian adresów — wszystko na tym samym kluczu API.

WooCommerce

Podpowiedzi adresów w zamówieniu: klient wybiera adres z listy, a ulica z numerem, kod pocztowy i miejscowość wypełniają się same. Klasyczny i blokowy koszyk, adres wysyłki i rozliczeniowy.

Pobierz wtyczkę (.zip)

  1. Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer → wybierz plik ZIP → Włącz.
  2. Utwórz darmowy klucz API i ogranicz go do domeny sklepu.
  3. Wklej klucz w Ustawienia → PolskieAdresy.pl.

PrestaShop 1.7, 8 i 9

Te same podpowiedzi w zamówieniu i książce adresowej klienta. Działa tylko, gdy wybrany kraj to Polska.

Pobierz moduł (.zip)

  1. Moduły → Menedżer modułów → Załaduj moduł → wybierz plik ZIP.
  2. Utwórz darmowy klucz API i ogranicz go do domeny sklepu.
  3. Konfiguruj → wklej klucz → Zapisz.

Widget do dowolnego formularza

Jedna linijka HTML — bez bibliotek. Szczegóły i przykłady: widget do formularzy.

<script src="https://polskieadresy.pl/widget.js" data-input="#adres" data-key="pa_…"
  data-fill-kod_pocztowy="#kod" data-fill-miejscowosc="#miasto"></script>

Serwer MCP dla asystentów AI

Adres serwera: https://polskieadresy.pl/mcp (MCP Streamable HTTP). Klucz API podajesz w konfiguracji łącznika. Wymaga klucza z darmowego konta (nagłówek Authorization: Bearer pa_… albo X-API-Key); wywołania liczą się w limitach Twojego planu.

Claude, ChatGPT i inne aplikacje

Claude (claude.ai i aplikacja): Ustawienia → Łączniki → Dodaj własny łącznik → adres https://polskieadresy.pl/mcp (klucz API w polu nagłówka autoryzacji, jeśli aplikacja je udostępnia; w pozostałych przypadkach użyj konfiguracji z kluczem poniżej).

ChatGPT (tryb dewelopera): Ustawienia → Aplikacje i łączniki → Utwórz → adres serwera MCP jak wyżej.

Claude Code:

claude mcp add --transport http polskieadresy https://polskieadresy.pl/mcp --header "Authorization: Bearer pa_TWÓJ_KLUCZ"

Cursor, VS Code i inne (plik konfiguracji)

{
  "mcpServers": {
    "polskieadresy": {
      "type": "http",
      "url": "https://polskieadresy.pl/mcp",
      "headers": {
        "Authorization": "Bearer pa_TWÓJ_KLUCZ"
      }
    }
  }
}

Narzędzia

NarzędzieCo robi
szukaj_adresuWyszukuje adresy, ulice, miejscowości i kody pocztowe w Polsce (PRG/TERYT). Toleruje literówki i brak polskich znaków. Zwraca m.in. pełny adres, kod pocztowy, gminę, powiat, województwo, kody TERYT i współrzędne.
geokodujZamienia jeden lub wiele adresów zapisanych tekstem na współrzędne, adres znormalizowany i kod pocztowy, z oceną pewności dopasowania. Dla wielu adresów podaj listę (maks. 100).
odwrotne_geokodowanieZnajduje najbliższy adres (punkt adresowy PRG) dla podanych współrzędnych WGS84 w Polsce, najbliższą miejscowość i odległość do morza.
kod_pocztowyZwraca miejscowości i ulice (z zakresami numerów) objęte kodem pocztowym w formacie XX-XXX.
kod_dla_adresuUstala kod pocztowy konkretnego adresu (miejscowość, ulica, numer budynku).
szczegoly_adresuPełne dane adresu o danym id (z wyników wyszukiwania): jednostki administracyjne, TERYT, budynek (BDOT10k), działka ewidencyjna, obwód wyborczy, szkoły, komunikacja, ceny mieszkań, statystyki gminy, okolica i zagrożenia.
terytOpisuje jednostkę podziału terytorialnego wg kodu TERYT: TERC (2, 4 lub 7 cyfr) albo SIMC (7 cyfr miejscowości).
okolicaNajbliższe punkty wokół współrzędnych: apteki, sklepy spożywcze, przychodnie, szpitale, poczty, paczkomaty, bankomaty, stacje paliw, szkoły i przystanki — z odległościami.

Każde wywołanie narzędzia liczy się jako jedno zapytanie API (geokodowanie listy — jak w API, za każdy adres).

Monitoring zmian adresów

Zapisz adresy klientów, punktów dostaw lub nieruchomości — po każdej cotygodniowej aktualizacji danych dostaniesz webhook (JSON z podpisem HMAC-SHA256) lub e-mail, gdy zmieni się kod pocztowy, nazwa ulicy, miejscowość, gmina lub kody TERYT albo adres zniknie z rejestru.

PlanMonitorowane adresy
Free100
Start5000
Business200 000

Przejdź do monitoringu · API monitoringu

REST API

Pełna dokumentacja: /api/, specyfikacja OpenAPI 3.1. Hurtowa normalizacja plików CSV/XLSX: /normalizacja/.

Najczęstsze pytania

Czy wtyczka WooCommerce działa z nowym koszykiem blokowym?

Tak. Wtyczka obsługuje klasyczny formularz zamówienia (shortcode) i koszyk blokowy WooCommerce, adres rozliczeniowy i wysyłki oraz edycję adresów w „Moje konto”. Deklaruje zgodność z HPOS.

Czy do wtyczki potrzebny jest klucz API?

Tak. Wtyczka korzysta z API, które wymaga klucza. Załóż darmowe konto (plan Free: 5000 zapytań miesięcznie) albo wybierz plan płatny, wklej klucz w ustawieniach wtyczki i ogranicz go do domeny sklepu w panelu.

Co to jest serwer MCP?

Model Context Protocol to otwarty standard, przez który asystenci AI (Claude, ChatGPT, Cursor i inne) korzystają z zewnętrznych narzędzi. Po dodaniu naszego serwera asystent sam wyszuka adres, kod pocztowy czy kod TERYT w urzędowych danych zamiast zgadywać.

Jak działa monitoring zmian adresów?

Zapisujesz swoje adresy w panelu albo przez API. Po każdej cotygodniowej aktualizacji danych PRG i TERYT porównujemy je z nową bazą i wysyłamy webhook lub e-mail, gdy zmieni się kod pocztowy, nazwa ulicy, miejscowość, gmina, kody TERYT albo punkt adresowy zostanie usunięty.

💬 Pomoc B2B / WhatsApp
👨‍💻Inżynier B2B OnlineWsparcie integracji API adresów

Pomożemy wdrożyć API, dobrać plan i przygotować ofertę dla firmy.

✉️[email protected]Wyceny, plan Business, faktury