CommunityRecherche & Datenanalysegithub.com

skuio/sku-skills

Open-Source E-Commerce-Agenten-Fähigkeiten für die SKU.io-API – einmal erstellt, für Claude, OpenAI und Gemini generiert.

Was ist sku-skills?

Diese Fähigkeitenbibliothek, 'skuio/sku-skills', bietet spezialisierte Agenten-Fähigkeiten für die SKU.io-API, die es Entwicklern und KI-Agenten ermöglicht, Produktsuchen und -abrufe auszuführen. Sie unterstützt mehrere KI-Plattformen wie Claude Code, Cursor, Codex, OpenAI und Gemini und stellt sicher, dass Agenten die API konsistent nutzen können. Die Fähigkeiten umfassen verschiedene Lookup-Methoden, darunter Suche nach exakter SKU, Barcode (UPC/EAN/GTIN), Teilsuche und Produkt-ID, sodass Agenten je nach Kontext die spezifischste Methode wählen können. Jede Fähigkeit behandelt Authentifizierung, Fehlerbehandlung und Paginierung und bietet klare Anleitungen für die Agenten, um mehrdeutige Ergebnisse zu disambiguieren oder fehlende Produkte zu melden. Die Bibliothek ist Open-Source auf GitHub verfügbar, sodass die Community Verbesserungen beisteuern kann, um Agenten-Workflows für verschiedene KI-Assistenten konsistent zu gestalten.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add skuio/sku-skills

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Ein Produkt finden

Nutze diese Fähigkeit, um aus „dem blauen Widget” oder einem gescannten Barcode ein konkretes SKU.io-Produkt zu machen – seine id, sku, Name und Details – damit nachgelagerte Fähigkeiten einen eindeutigen Bezug haben.

Die richtige Suche wählen

Du hast…AufrufWarum
Eine exakte SKUGET /api/products/by-sku?sku=WIDGET-BLUE-01Direkt, einzelnes Ergebnis
Einen gescannten Barcode (UPC/EAN/GTIN)GET /api/products/barcode-lookup?code=0123456789012Löst den Barcode zu seinem Produkt auf (Parameter ist code)
Einen Teil-Namen oder Teil-SKUGET /api/products/search?query=blue widgetUnscharf, kann mehrere Treffer liefern
Eine numerische Produkt-IDGET /api/products/{id}Vollständiger Datensatz, wenn du die ID bereits hast

Bevorzuge immer die spezifischste Suche, die möglich ist. Verwende search nur, wenn du keine exakte SKU oder keinen Barcode hast – es können mehrere Kandidaten zurückkommen, die du disambiguieren musst.

Schritte

  1. Wähle die obige Suche basierend auf dem, was dir gegeben wurde.

  2. Sende die Anfrage mit deinem Bearer-Token (Bereich products:read):

    curl -sS "https://$SKU_TENANT.sku.io/api/products/by-sku?sku=WIDGET-BLUE-01" \
      -H "Authorization: Bearer $SKU_PAT" -H "Accept: application/json"
    
  3. Behandle das Ergebnis:

    • Genau ein Treffer → erfasse seine id und sku; du bist fertig.
    • Suche hat mehrere zurückgegeben → schränke durch Abgleich der exakten sku ein, oder zeige dem Benutzer die besten Kandidaten (Name + SKU) an und frage, welcher es ist. Wähle nicht stillschweigend den ersten.
    • Kein Treffer → das Produkt existiert möglicherweise nicht oder ist archiviert. Melde dies, anstatt eine ID zu erfinden. Ziehe eine breitere search-Abfrage in Betracht, bevor du aufgibst.

Hinweise

  • search ist paginiert – siehe shared/pagination.md. Die besten Treffer befinden sich auf der ersten Seite; für eine Suche musst du selten weiterblättern.
  • Die Produkt-id ist der stabile Schlüssel, den andere Fähigkeiten erwarten (z.B. product_id in einer Verkaufsauftragsposition). Bevorzuge es, id nachgelagert weiterzugeben, anstatt jedes Mal per SKU neu aufzulösen.

API-Operationen

MethodePfadBeschreibung
GET/api/products/searchUnscharfe Produktsuche nach Name oder SKU-Fragment.
GET/api/products/by-skuEin einzelnes Produkt anhand seiner exakten SKU abrufen.
GET/api/products/barcode-lookupEinen gescannten Barcode (UPC/EAN/GTIN) zu einem Produkt auflösen.
GET/api/products/{id}Den vollständigen Produktdatensatz anhand seiner numerischen ID abrufen.

Authentifizierung

Jede Anfrage authentifiziert sich mit einem SKU.io Personal Access Token, der als Bearer-Token gesendet wird:

Authorization: Bearer <YOUR_SKU_PAT>
  • Basis-URL: https://{tenant}.sku.io (ersetze {tenant} mit deiner Konto-Subdomain)
  • Erforderliche Bereiche: products:read

Erstelle ein Token unter Einstellungen → Entwickler → Personal Access Tokens in der SKU.io Web-App. Siehe shared/authentication.md für den vollständigen Ablauf.


Verbessere diese Fähigkeit

Hat diese Fähigkeit nicht gereicht – ein unklarer Schritt, ein falscher Endpunkt oder etwas, das sie nicht abschließen konnte? Umgehe es nicht einfach: Halte fest, was schiefgelaufen ist, und erstelle einen Pull-Request, damit der nächste Agent besser abschneidet.

  • Repository: https://github.com/skuio/sku-skills
  • Bearbeite die kanonische Fähigkeit unter skills/<domain>/<name>/ (nicht diese generierte Datei), führe dann npm run build aus und erstelle einen PR. Externe Mitwirkende: Forke das Repository und erstelle den PR vom Fork.
  • Der vollständige Agenten-Workflow befindet sich in AGENTS.md.

Dein Agent kann dies von Anfang bis Ende durchführen. Die Bibliothek wird jedes Mal besser, wenn jemand eine Korrektur sendet.

Verwandte Skills