Jak używać commonspecs

Ta ścieżka jest dla osób z umiejętnościami technicznymi albo z własnym agentem AI: Claude Code, Claude Desktop, claude.ai, Cursor i ponad 70 innych agentów wspierających skille. Nie masz agenta? Skorzystaj z aplikacji iOS lub Android.

1. Zainstaluj skill

Jedno polecenie kopiuje skill do katalogu skilli Twojego agenta:

npx skills add commonspecs/skills

Alternatywnie skopiuj skill z repozytorium commonspecs/skills wprost do katalogu skilli swojego agenta — dla Claude Code jest to ~/.claude/skills/.

2. Pytaj

Zadaj agentowi pytanie o produkt albo usługę, a on dobierze właściwe wywołanie:

• poproś o radę, co kupić w danej kategorii — „poleć mi dobrą pastę do zębów" — a agent przejrzy ranking tej kategorii przez search_products
• dorzuć warunek na parametrze („tylko lniane", „mocno gazowane"), a zawęzi kategorię filtrami dopasowanymi do zapisanych faktów
• zapytaj o konkretną cechę produktu, który nazwiesz — agent odnajdzie go po marce i modelu przez search_products, a potem pobierze szczegóły przez get_product
• poproś o porównanie produktu X z produktem Y — agent użyje compare_products
• zrób zdjęcie metki — agent odczyta wartości i kod EAN, po czym je wyszuka; zdjęcie nie opuszcza Twojego urządzenia

Zalecane: dodaj połączenie MCP

Polecamy połączyć skill z MCP — komunikuje się z Twoim kontem przez OAuth, więc nie trzeba tworzyć tokena ani nim zarządzać. Klienty z natywnymi konektorami (Claude Desktop, claude.ai, Cursor, …) logują się w przeglądarce, a skill wykrywa połączenie i korzysta z jego narzędzi. Klient, który nie obsługuje skilli, może używać MCP samodzielnie.

Adres serwera:

https://api.commonspecs.com/mcp

Claude Code:

claude mcp add --transport http commonspecs https://api.commonspecs.com/mcp

Inne klienty (Cursor, VS Code, konektory Claude Desktop) przyjmują konfigurację serwera MCP po HTTP z tym samym adresem — klienty z obsługą OAuth logują się przy pierwszym użyciu. Dla klienta obsługującego wyłącznie stdio użyj mostka:

npx mcp-remote https://api.commonspecs.com/mcp

Nie chcesz używać MCP? Ustaw w zmiennych środowiskowych token API wygenerowany w Twoim profilu — skill wróci wtedy do bezpośrednich wywołań:

export COMMONSPECS_API_TOKEN="cs_live_…"

Preferencje zakupowe są zapisane na Twoim koncie i jadą z każdym odczytem — serwer zawęża wyniki do Twojego rynku i lokalności, a cel jakościowy oraz tryb kontrybucji przekazuje agentowi do zastosowania.

Co robi z odpowiedzią

Skill podaje każdy fakt razem z jego pewnością (confidence), ostrożnie traktuje wartości słabo potwierdzone, pokazuje obie strony spornej wartości i pokazuje, czego rekordowi jeszcze brakuje (missing_fields). Nigdy nie zmyśla wartości, której nie dostał z bazy. Gdy jakieś pole warto potwierdzić w dodatkowym źródle, a Ciebie to interesuje, skill może je pobrać i odesłać — w ten sposób rozmowa zasila bazę.

Jak budowany jest ranking — zobacz metodykę.