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

nbp — скилл для Claude Code: курсы валют и установка

Скилл nbp для Claude Code получает курсы Narodowy Bank Polski и цены на золото. Считает налоговый пересчёт валютного счёта в PLN по дате счёта.

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

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

Что делает 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-code

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

~/.claude/skills/nbp/SKILL.md

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

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

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

Все скиллы по теме «Финансы и бизнес» →
deweloperuch.pl (unofficial) MBratkowski deweloperuch.pl (unofficial) — MCP-сервер с доступом ИИ к ценам на новостройки в Польше, зарегистрированным сделкам и статистике GUS и NBP. Данные можно сравнивать с предложениями. CX Codex +1 ★ 29звёзд репо financial-deep-research rebyteai-template Скилл financial-deep-research для глубокого финансового анализа: собирает данные из множества источников, проверяет утверждения и оформляет отчёт со ссылками. CX Codex +1 987установок trading-expert personamanagmentlayer Скилл trading-expert обучает агента алгоритмической торговле, стратегиям на Python и бэктестингу. Помогает проектировать обработку рыночных данных и рассчитывать метрики риска. CX Codex +1 970установок banking-expert personamanagmentlayer Скилл banking-expert для Claude Code. Даёт агенту справочник по core banking, KYC/AML, платежам и банковским регламентам. Запускается, когда в коде появляются счета, переводы или проверка клиента. CX Codex +1 805установок k2f-receipt suzheng Скилл k2f-receipt собирает чеки об оплате и отчёты о проделанной работе из ваших данных: суммы, ссылки и авторство сходятся, лишнего не придумывает. CX Codex +1 659установок pluggy-open-finance pluggy Скилл pluggy-open-finance задаёт правила работы с данными Open Finance через Pluggy. Он пригодится при интеграции счетов, транзакций, инвестиций, кредитов и данных о пользователях. CX Codex +1 594установок

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

Весь набор →
krs Получает записи польского реестра KRS через API Министерства юстиции. По запросу о компании он показывает её статус, состав органов и правила подписания договоров. CX Codex +1 ★ 60звёзд репо przetargi Скилл przetargi для Claude Code ищет польские закупки в BZP и показывает сведения об объявлении. Запросы можно фильтровать по теме, региону заказчика, CPV и датам публикации. CX Codex +1 ★ 60звёзд репо solid-jobs Ищет вакансии и статистику зарплат на SOLID.Jobs. Фильтрует предложения по запросу, городу, опыту и удалённой работе. CX Codex +1 ★ 60звёзд репо inpost Отслеживает посылки InPost и ищет постаматы с пунктами выдачи в Польше. Запускается на запрос о статусе отправления, адресе постамата или ближайшей точке. 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звёзд репо biala-lista Скилл biala-lista для Claude Code проверяет польские компании и их статус плательщика VAT по NIP или REGON. Запускается при проверке контрагента, счёта или польской фактуры. CX Codex +1 ★ 60звёзд репо

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

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