biala-lista — скилл для Claude Code: проверка компаний и установка
Скилл biala-lista для Claude Code проверяет польские компании и их статус плательщика VAT по NIP или REGON. Запускается при проверке контрагента, счёта или польской фактуры.
MIT ★ 60 обновлён 2026-11-15
/plugin marketplace add b44x/ai-polish-skills
/plugin install biala-lista@polskie-skilleЧто делает biala-lista
Скилл запрашивает официальный реестр Министерства финансов Польши и возвращает данные о компании и VAT в формате JSON. По NIP или REGON он находит название, адрес, KRS и расчётные счета; по номеру счёта ищет компанию, а командой check сверяет счёт с NIP. Для проверки контрольных сумм NIP, REGON и NRB можно использовать локальную команду validate без обращения к API.
Внутри — скрипт scripts/biala_lista.py. Для запуска нужны Python 3.8+ и сетевой доступ к wl-api.mf.gov.pl; внешние библиотеки и авторизация не требуются. Для проверки на прошедшую дату скрипту передают --date=YYYY-MM-DD. Лимит API — 300 запросов в день на IP.
Какие задачи решает
- проверить статус VAT польской компании по NIP
- найти компанию по REGON или номеру банковского счёта
- сверить счёт контрагента с NIP перед переводом
- проверить контрольную сумму NIP, REGON или NRB без API
Примеры запросов агенту
- Проверь статус VAT компании с NIP
5260250274и покажи её расчётные счета. - Сверь счёт
PL61109010140000071219812874с NIP5260250274в белом списке. - Проверь контрольную сумму этого REGON без запроса к API:
123456789.
Как установить biala-lista
1Через маркетплейс плагинов
/plugin marketplace add b44x/ai-polish-skills/plugin install biala-lista@polskie-skilleКоманда ставит плагин biala-lista целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill biala-lista -a claude-code3Вручную: положить файлы
~/.claude/skills/biala-lista/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/biala-lista/
1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill biala-lista -a codex2Вручную: положить файлы
.agents/skills/biala-lista/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill biala-lista -a cursor2Вручную: положить файлы
.cursor/skills/biala-lista/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install b44x/ai-polish-skills skills/biala-lista2Вручную: положить файлы
.github/skills/biala-lista/SKILL.md1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill biala-lista -a gemini-cli2Командой платформы
gemini skills install https://github.com/b44x/ai-polish-skills --path skills/biala-listaВручную: положить файлы
.devin/skills/biala-lista/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о biala-lista
Как установить biala-lista в Claude Code?
Добавь маркетплейс командой /plugin marketplace add b44x/ai-polish-skills, затем установи скилл командой /plugin install biala-lista@polskie-skille.
Что делает biala-lista?
Скилл получает сведения о польских компаниях и статусе VAT из официального реестра. Он также проверяет, числится ли банковский счёт за компанией, ищет компанию по счёту и локально проверяет контрольные суммы.
Что нужно для работы biala-lista?
Нужны Python 3.8+ и сетевой доступ к wl-api.mf.gov.pl. Внешние библиотеки и авторизация не требуются.
Исходный текст
SKILL.md · MIT
---
name: biala-lista
display_name: Biała Lista Podatników VAT
version: 1.0.0
description: >-
Check Polish businesses and VAT status in the official Ministry of Finance White
List (Biała Lista Podatników VAT). Verify active VAT payer status (Czynny /
Zwolniony / Niezarejestrowany), legal company name, REGON, KRS, registered address,
and settlement bank accounts by NIP or REGON. Check if a contractor's bank account
is on the whitelist before making B2B transfers (critical for split payment and
tax deductibility above 15,000 PLN). Reverse-lookup company by 26-digit Polish bank
account number (NRB/IBAN). Validate NIP, REGON, and IBAN checksums offline. Use
whenever the user asks about NIP, REGON, Biała Lista VAT, "sprawdź NIP", "sprawdź kontrahenta",
"status VAT spółki", "czy numer konta jest na białej liście", or verifying a Polish invoice.
category: finance
language: pl
country: PL
license: MIT
author: Michell Hoduń (https://github.com/b44x)
repository: https://github.com/b44x/ai-polish-skills
network: true
authentication: none
source: Ministerstwo Finansów (KAS)
source_type: official_api
official: true
homepage: https://www.podatki.gov.pl/wykaz-podatnikow-vat-wyszukiwarka/
documentation: https://www.gov.pl/web/kas/api-wykazu-podatnikow-vat
rate_limit: 300 requests/day per IP
last_verified: 2026-09-28
tags:
- biala-lista
- vat
- nip
- regon
- split-payment
- podatki
- faktury
- rachunek-bankowy
compatibility: Python 3.8+ (standard library only); network access to wl-api.mf.gov.pl.
---
# Biała Lista Podatników VAT
Fetches official Polish company and VAT status data from the Ministry of Finance (*Ministerstwo Finansów*)
using `scripts/biala_lista.py`. Always outputs structured JSON.
## Running the script
Run from this skill's directory (or use relative path from repo root):
| OS | Command |
|---|---|
| Linux / macOS | `python3 scripts/biala_lista.py <command> …` |
| Windows | `py scripts/biala_lista.py <command> …` (or `python`) |
Zero external dependencies required (standard library only).
## Workflow
1. **Identify the query type:**
- **NIP (10 digits)**: User provides NIP or asks about a company → `python3 scripts/biala_lista.py nip <nip>`.
- **Bank Account (26 digits)**: User wants to know who owns an account or if it's safe to pay →
- Check specific NIP + account match: `python3 scripts/biala_lista.py check <nip> <account>`
- Find company by account number: `python3 scripts/biala_lista.py account <account>`
- **REGON (9 or 14 digits)**: User provides REGON → `python3 scripts/biala_lista.py regon <regon>`.
- **Syntax verification (offline)**: User asks to validate NIP/REGON/IBAN without querying API → `python3 scripts/biala_lista.py validate <value>`.
2. **Historical or specific date:**
- Add `--date=YYYY-MM-DD` when checking status for a past invoice or event (defaults to today).
3. **Interpret the results:**
- `statusVat`: `"Czynny"` (active VAT payer — eligible for standard VAT deduction), `"Zwolniony"` (exempt), `"Niezarejestrowany"` (not registered).
- `accountAssigned`: `"TAK"` (account is registered on the White List — safe for payments > 15,000 PLN) or `"NIE"`.
- `requestId`: Always note the `requestId` when reporting verification for financial/tax records — it provides legal proof of due diligence (*należyta staranność*) under Polish tax law.
## Commands
| Command | Description | Returns |
|---|---|---|
| `nip <nip> [--date=YYYY-MM-DD]` | Look up company details & VAT status by NIP | `name`, `statusVat`, `isVatActive`, `address`, `krs`, `regon`, `accounts`, `representatives`, `requestId` |
| `check <nip> <account> [--date=YYYY-MM-DD]` | Verify if bank account is on the White List for this NIP | `accountAssigned` (`"TAK"` / `"NIE"`), `isAssigned`, `bank`, `requestId`, `requestDateTime` |
| `account <account> [--date=YYYY-MM-DD]` | Reverse-lookup company associated with a bank account | `accountFormatted`, `bank`, `subjects` list with company details |
| `regon <regon> [--date=YYYY-MM-DD]` | Look up company details by REGON (9 or 14 digits) | Same object as `nip` |
| `validate <value>` | Offline checksum validation for NIP, REGON, or NRB | `type`, `valid`, `formatted`, `bank` (if NRB), `message` |
Field reference and legal context: [references/output.md](references/output.md).
## Exit codes
JSON goes to stdout; errors go to stderr as `{"error": "...", "type": "..."}`.
| Code | Meaning | What to do |
|---|---|---|
| `0` | Success | Use the JSON output |
| `2` | Not found | Subject or account not found in the official registry |
| `64` | Validation / Bad usage | Invalid NIP/REGON/account checksum or bad arguments |
| `69` | Network / API / Rate limit | Retry once; check internet connection |
## Rules
- For B2B transfers above 15,000 PLN gross, always emphasize checking both `statusVat: "Czynny"` and `accountAssigned: "TAK"`.
- If an entity uses virtual accounts (`hasVirtualAccounts: true`), remind the user that `check <nip> <account>` should be used rather than inspecting the static `accounts` list.
- Stripping spaces, dashes, and the `PL` prefix is handled automatically by the script.
© Michell Hoduń (https://github.com/b44x) · MIT · b44x/ai-polish-skills