К основному содержанию
скилл CX Codex

biala-lista — скилл для Claude Code: проверка компаний и установка

Скилл biala-lista для Claude Code проверяет польские компании и их статус плательщика VAT по NIP или REGON. Запускается при проверке контрагента, счёта или польской фактуры.

MIT ★ 60 обновлён 2026-11-15

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add b44x/ai-polish-skills
/plugin install biala-lista@polskie-skille
Открыть на GitHub

Что делает 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 с NIP 5260250274 в белом списке.
  • Проверь контрольную сумму этого 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-code

3Вручную: положить файлы

~/.claude/skills/biala-lista/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/biala-lista/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →
entity-verification entia MCP-сервер entity-verification проверяет компании, VAT, владельцев и риск-сигналы через данные BORME, VIES, GLEIF и Wikidata. CX Codex +1 16 045установок czech-vat-mcp janmacher02-xl8y MCP-сервер czech-vat-mcp проверяет чешские компании и банковские счета, статус плательщика НДС и номера НДС стран ЕС. Пригодится перед расчётами с поставщиками. CX Codex +1 889установок VAT Validator MCP ojaskord MCP-сервер VAT Validator MCP проверяет номера НДС в реестрах ЕС, Великобритании и Австралии прямо через ИИ-агента. Помогает сверить имя в инвойсе до проведения оплаты. CX Codex +1 42установок margin-analyzer ilyautov Скилл margin-analyzer для Claude Code и Codex разбирает выручку и затраты по товарам и услугам, учитывает НДС и показывает сценарии изменения цены. Считает, какие позиции приносят прибыль. CX Codex +1 ★ 38звёзд репо norman norman-finance Подключает финансовый сервис Norman к Claude Code для выставления счетов, сверки транзакций и подготовки налоговой отчётности в Германии и Польше. ★ 65звёзд репо Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres Ekwo-ai Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres — MCP-сервер для Claude Code связывает агента с бухгалтерией, счетами, проводками и НДС с соблюдением прав доступа. CX Codex +1 ★ 43звёзд репо

Из того же набора52

Весь набор →
nbp Скилл nbp для Claude Code получает курсы Narodowy Bank Polski и цены на золото. Считает налоговый пересчёт валютного счёта в PLN по дате счёта. CX Codex +1 ★ 60звёзд репо filmweb Получает сведения о фильмах и сериалах с Filmweb. Агент включает его для поиска по названию или ссылке, вопросов об актёрах, оценках, премьерах и VOD. CX Codex +1 ★ 60звёзд репо dzialki Скилл dzialki для Claude Code находит польские кадастровые участки через сервис ULDK. Запросите участок по идентификатору EGiB, кадастровому району с номером или точке на карте. CX Codex +1 ★ 60звёзд репо odjazdy Скилл odjazdy для Claude Code показывает остановки и ближайшие отправления автобусов и трамваев в Гданьске, Познани и Щецине. Запрашивайте табло по названию остановки или её ID. CX Codex +1 ★ 60звёзд репо terminy Скилл terminy для Claude Code считает рабочие дни, праздники и сроки по польским правилам. Запускается на запросы о датах платежей, налогов и нормах рабочего времени. CX Codex +1 ★ 60звёзд репо nieruchomosci Скилл nieruchomosci для Claude Code ищет записи о сделках с недвижимостью в польском реестре RCN. Можно искать рядом с координатами или в заданной области и фильтровать результаты по дате, рынку и площади. CX Codex +1 ★ 60звёзд репо sejm Скилл sejm для Claude Code обращается к официальному API польского Сейма. Агент подключает его для поиска депутатов, голосований, законопроектов и депутатских запросов. CX Codex +1 ★ 60звёзд репо prawo Скилл prawo для Claude Code ищет польские законы через официальный API Сейма. Он находит статьи, статус акта и сведения о поправках. CX Codex +1 ★ 60звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой