nbp — скилл для Claude Code: курсы валют и установка
Скилл nbp для Claude Code получает курсы Narodowy Bank Polski и цены на золото. Считает налоговый пересчёт валютного счёта в PLN по дате счёта.
MIT ★ 60 обновлён 2026-11-15
/plugin marketplace add b44x/ai-polish-skills
/plugin install nbp@polskie-skilleЧто делает nbp
Скилл получает официальные курсы валют NBP, пересчитывает суммы между валютами и возвращает цену золота за грамм и тройскую унцию. Он включается на запросы о курсе валюты, конвертации счёта или цене золота.
Для валютного счёта скрипт scripts/nbp.py выбирает курс за последний рабочий день перед датой счёта, пропуская выходные и праздники. Команды возвращают структурированный JSON. Нужны Python 3.8 или новее и сетевой доступ к api.nbp.pl; используются только стандартные библиотеки Python.
Какие задачи решает
- узнать текущий или исторический курс валюты NBP
- пересчитать валютный счёт в PLN по дате счёта
- конвертировать сумму между двумя валютами
- получить цену золота за грамм и тройскую унцию
Примеры запросов агенту
- Узнай официальный курс EUR на сегодня.
- Пересчитай счёт на 1500 EUR от 2026-09-28 в PLN.
- Сколько стоит золото NBP за грамм и тройскую унцию?
Как установить nbp
1Через маркетплейс плагинов
/plugin marketplace add b44x/ai-polish-skills/plugin install nbp@polskie-skilleКоманда ставит плагин nbp целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill nbp -a claude-code3Вручную: положить файлы
~/.claude/skills/nbp/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/nbp/
1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill nbp -a codex2Вручную: положить файлы
.agents/skills/nbp/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill nbp -a cursor2Вручную: положить файлы
.cursor/skills/nbp/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install b44x/ai-polish-skills skills/nbp2Вручную: положить файлы
.github/skills/nbp/SKILL.md1Через Skills CLI (Vercel)
npx skills add b44x/ai-polish-skills --skill nbp -a gemini-cli2Командой платформы
gemini skills install https://github.com/b44x/ai-polish-skills --path skills/nbpВручную: положить файлы
.devin/skills/nbp/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о nbp
Как установить nbp в Claude Code?
Выполни /plugin marketplace add b44x/ai-polish-skills и затем /plugin install nbp@polskie-skille.
Что делает nbp?
Получает курсы валют и цены на золото NBP, конвертирует суммы и рассчитывает пересчёт валютного счёта в PLN по курсу за последний рабочий день перед датой счёта.
Что нужно для работы nbp?
Нужны Python 3.8 или новее и сетевой доступ к api.nbp.pl. Внешние библиотеки не требуются.
Исходный текст
SKILL.md · MIT
---
name: nbp
display_name: Narodowy Bank Polski (NBP)
version: 1.0.0
description: >-
Fetch official exchange rates, calculate tax conversions for foreign currency invoices,
and check gold prices from Narodowy Bank Polski (NBP). Get current or historical average
rates (Table A & B) for EUR, USD, GBP, CHF, etc. Calculate foreign currency invoices in
PLN according to Polish tax law (Art. 31a ustawy o VAT / Art. 11a ustawy o PIT) by
automatically looking up the official NBP rate from the last business day preceding the
invoice date. Convert between any currency pairs. Get official gold prices per gram and
troy ounce. Use whenever the user asks about "kurs euro", "kurs dolara", "tabela NBP",
"kurs do faktury", "przelicz walutę NBP", "cena złota NBP", or foreign invoice conversion.
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: Narodowy Bank Polski
source_type: official_api
official: true
homepage: https://nbp.pl
documentation: https://api.nbp.pl/
rate_limit: fair use
last_verified: 2026-09-28
tags:
- nbp
- waluty
- kursy-walut
- euro
- dolar
- podatki
- vat
- zloto
- faktury
compatibility: Python 3.8+ (standard library only); network access to api.nbp.pl.
---
# Narodowy Bank Polski (NBP)
Fetches official currency exchange rates and gold prices from Narodowy Bank Polski using
`scripts/nbp.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/nbp.py <command> …` |
| Windows | `py scripts/nbp.py <command> …` (or `python`) |
Zero external dependencies required (standard library only).
## Workflow
1. **Foreign Currency Invoices (Tax conversion):**
- Whenever the user asks to convert an invoice or calculate VAT/income tax for a foreign currency:
`python3 scripts/nbp.py invoice <amount> <currency> <invoice_date>`
*Example:* `python3 scripts/nbp.py invoice 1500 EUR 2026-09-28`
- The script automatically locates the official NBP table published on the **last business day preceding the invoice date** (skipping weekends and holidays) in accordance with Art. 31a ust. 1 Ustawy o VAT.
- Always report the `tableNumber`, `taxEffectiveDate`, `exchangeRate`, and `amountPln`.
2. **Single Currency Rate:**
- User asks for the current or historical rate of a currency (e.g. "ile kosztuje euro dzisiaj?"):
`python3 scripts/nbp.py rate EUR`
`python3 scripts/nbp.py rate USD --date 2026-09-15`
3. **General Currency Conversion:**
- Convert arbitrary amounts between currencies:
`python3 scripts/nbp.py convert 250 USD EUR`
4. **Gold Price:**
- User asks for gold prices:
`python3 scripts/nbp.py gold`
- Returns official NBP price per 1 gram and calculated per troy ounce (oz) in PLN.
5. **Full Tables:**
- List all rates from Table A (major) or B (exotic):
`python3 scripts/nbp.py table A`
## Commands
| Command | Description | Returns |
|---|---|---|
| `invoice <amount> <currency> <date>` | Convert invoice to PLN according to Polish tax law (preceding business day) | `invoiceDate`, `taxEffectiveDate`, `tableNumber`, `exchangeRate`, `amountPln`, `legalBasis` |
| `rate <currency> [--date D]` | Get mid exchange rate for currency (Table A or B) | `currency`, `mid`, `tableNumber`, `effectiveDate` |
| `convert <amount> <from> <to> [--date D]` | Convert between any two currencies | `amount`, `convertedAmount`, `effectiveRate`, `date` |
| `table [A\|B\|C] [--date D]` | Fetch complete exchange rates table | `tableNumber`, `effectiveDate`, `rates` list |
| `gold [--date D]` | Get official gold price in PLN (per gram and troy ounce) | `pricePerGramPln`, `pricePerTroyOuncePln`, `priceFormatted` |
Field reference and statutory tax rules: [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 | Invalid currency code or date out of range / holiday |
| `64` | Bad usage / validation | Invalid date format (expected YYYY-MM-DD) or missing arguments |
| `69` | Network / NBP server error | Retry once; check internet connection |
## Rules
- For tax and invoicing questions, always use `invoice` rather than `rate` — Polish tax law strictly forbids using the rate from the same day as the invoice.
- Cite the official `tableNumber` (e.g. `187/A/NBP/2026`) in your answer to ensure full legal audit compliance.
© Michell Hoduń (https://github.com/b44x) · MIT · b44x/ai-polish-skills