Description

n8n Polish Nodes


Collection of n8n community nodes for Polish services. Each node is a standalone npm package that can be installed independently.

Available Nodes

| Node | Service | npm Package | Description |
|——|———|————-|————-|
| SMSAPI | smsapi.pl |  | Polish SMS gateway |
| CEIDG | dane.biznes.gov.pl |  | Polish business registry lookup |
| InPost | inpost.pl |  | Polish parcel locker & courier service |
| Biala Lista VAT | mf.gov.pl |  | Polish VAT taxpayer white list verification |
| KRS | krs.gov.pl |  | Polish National Court Register company lookup |
| GUS REGON | api.stat.gov.pl |  | Polish REGON business registry (SOAP) |
| VIES | ec.europa.eu |  | EU VAT number validation |
| NBP | api.nbp.pl |  | Exchange rates from National Bank of Poland |
| NFZ | api.nfz.gov.pl |  | Healthcare waiting times from National Health Fund |
| Ceneo | ceneo.pl |  | Polish price comparison platform |
| LinkerCloud | linkercloud.com |  | Polish WMS/OMS fulfillment platform |

Installation

Install individual nodes in your n8n instance:

In your n8n custom nodes directory
cd ~/.n8n/custom
npm install n8n-nodes-smsapi

Or install via the n8n Community Nodes UI: Settings > Community Nodes > Install.

Development

Prerequisites

• Node.js 18 or 20
• pnpm 9+

Setup

git clone https://github.com/michalploneczka/n8n-polish-nodes.git
cd n8n-polish-nodes
pnpm install

Build

Build all packages
pnpm run build:all
Build a specific package
pnpm --filter n8n-nodes-smsapi run build

Test

Run all tests
pnpm run test:all
Test a specific package
pnpm --filter n8n-nodes-smsapi run test

Lint

Lint all packages
pnpm run lint:all

Local Development with n8n (Docker)

Use the included script to build, pack, and hot-reload nodes into a running n8n Docker container:

Install all packages into the running n8n container (default container name: n8n)
./scripts/dev-install.sh
Install a single package
./scripts/dev-install.sh ceidg
./scripts/dev-install.sh smsapi
Custom container name
CONTAINER=my-n8n ./scripts/dev-install.sh

The script builds all packages, packs them as tarballs, installs them inside the container’s custom nodes directory, and restarts n8n. Run it after every code change.

docker-compose.yml is included for quick local setup:

docker compose up -d
./scripts/dev-install.sh
Open http://localhost:5678

Local Development without Docker

cd packages/n8n-nodes-smsapi
pnpm run build
npm link
cd ~/.n8n/custom
npm link n8n-nodes-smsapi
npx n8n start

Publishing

Packages are published automatically via GitHub Actions when a version tag is pushed:

git tag n8n-nodes-smsapi@1.0.0
git push --tags

All packages are published with npm provenance attestation.

See PUBLISHING.md for detailed instructions.

Contributing

Contributions are welcome! Please open an issue first to discuss what you would like to change.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-node)
3. Make your changes
4. Run tests (pnpm run test:all)
5. Run lint (pnpm run lint:all)
6. Submit a pull request

License

MIT

Author

Michal Ploneczka – codersgroup.pl