Finanse Oficjalne API

Kursy walut i dane NBP dla agenta AI

Pobierz kurs waluty, numer tabeli NBP i dane historyczne. Skill przelicza waluty, obsługuje tryb faktury oraz cenę złota z API NBP.

Zainstaluj skill

Do czego służy ten skill?

Ten skill pobiera kursy walut bezpośrednio z API Narodowego Banku Polskiego. Zamiast samej liczby otrzymujesz także datę obowiązywania i numer tabeli, co ułatwia wykorzystanie wyniku w zestawieniu lub rozliczeniu.

Dostępne są odczyt jednej waluty, pełne tabele, przeliczanie kwot i oficjalna cena złota. Osobny tryb faktury dobiera kurs zgodnie z regułą zaimplementowaną w narzędziu i zwraca datę przyjętą do obliczenia. Warto wskazać cel przeliczenia, ponieważ zwykły kurs i tryb faktury pełnią różne funkcje.

  • Bieżące i historyczne kursy walut
  • Przeliczanie kwot oraz osobny tryb faktury
  • Tabele NBP i cena złota

Przykładowe pytania do agenta

  • Pokaż kurs EUR z NBP wraz z numerem tabeli.
  • Przelicz 100 USD na PLN według kursu ze wskazanego dnia.
  • Oblicz przeliczenie faktury w EUR w trybie faktury.

Podaj kwotę, walutę, datę i przeznaczenie wyniku. Agent powinien zachować numer tabeli i dzień kursu. Dla danych historycznych wskaż konkretny dzień zamiast polegać na bieżącej tabeli.

Zakres i ograniczenia

  • Kurs referencyjny NBP nie jest ofertą wymiany w banku lub kantorze.
  • Brak tabeli dla wybranego dnia wymaga uwzględnienia dat publikacji i celu przeliczenia.

Instalacja i uruchomienie

W terminalu, w katalogu projektu, uruchom instalator wybranego skilla:

curl -fsSL https://raw.githubusercontent.com/b44x/ai-polish-skills/main/install.sh | bash -s nbp

Instalator zapisuje instrukcje i skrypt w .agents/skills/nbp/. Agent odczytuje plik SKILL.md, a skrypt pobiera dane i zwraca wynik w JSON. Dostępne komendy sprawdzisz lokalnie:

python3 .agents/skills/nbp/scripts/nbp.py --help

Wymagany jest Python 3.8 lub nowszy; skrypt korzysta ze standardowej biblioteki. W Windows polecenie python3 można zastąpić py.

Pełne instrukcje i przykłady w SKILL.md ↗

← Wróć do wszystkich 17 skilli