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.
- Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer → wybierz plik ZIP → Włącz.
- Utwórz darmowy klucz API i ogranicz go do domeny sklepu.
- 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.
- Moduły → Menedżer modułów → Załaduj moduł → wybierz plik ZIP.
- Utwórz darmowy klucz API i ogranicz go do domeny sklepu.
- 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ędzie | Co robi |
|---|---|
szukaj_adresu | Wyszukuje 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. |
geokoduj | Zamienia 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_geokodowanie | Znajduje najbliższy adres (punkt adresowy PRG) dla podanych współrzędnych WGS84 w Polsce, najbliższą miejscowość i odległość do morza. |
kod_pocztowy | Zwraca miejscowości i ulice (z zakresami numerów) objęte kodem pocztowym w formacie XX-XXX. |
kod_dla_adresu | Ustala kod pocztowy konkretnego adresu (miejscowość, ulica, numer budynku). |
szczegoly_adresu | Peł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. |
teryt | Opisuje jednostkę podziału terytorialnego wg kodu TERYT: TERC (2, 4 lub 7 cyfr) albo SIMC (7 cyfr miejscowości). |
okolica | Najbliż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.
| Plan | Monitorowane adresy |
|---|---|
| Free | 100 |
| Start | 5000 |
| Business | 200 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.