Cookies 🍪

Diese Website verwendet Cookies, die Ihre Zustimmung brauchen.

Zum Inhalt springen
Nordalux
Hey 👋
Wir sind für dich da

Shopify AI Toolkit: Euren Shop per Prompt steuern

| Tobias Graeger
Illustration: Ein Laptop mit Terminal-Code in der Mitte. Links entstehen geordnete Shop-Elemente wie Produktkarten, Warenkorb und Statistiken aus goldenen Partikelströmen. Rechts zerfallen dieselben Elemente — ein Warndreieck, ein durchgestrichenes Preisschild und brechende UI-Karten zeigen die Risiken von KI-Automatisierung im Shopify-Shop.
Dieses Bild wurde mit Hilfe
von generativer KI erstellt.

Shopify hat diese Woche das AI Toolkit veröffentlicht. Open Source, auf GitHub, kostenlos. Das Toolkit verbindet KI-Coding-Tools wie Claude Code, Cursor oder VS Code Copilot direkt mit der Shopify-Plattform. Nicht über Umwege, nicht über Copy-Paste, sondern mit Live-Zugriff auf Dokumentation, API-Schemas und den Store selbst.

In einem kurzen Demo-Video auf X hat Shopify gezeigt, was damit gemeint ist: Ein Prompt wie „Optimize all my products for SEO" geht alle Produkte durch, schreibt Titel und Meta-Descriptions um und spielt die Änderungen direkt in den Shop ein. Ein anderer Prompt rabattiert sämtliche Produkte auf einen Schlag. Kein CSV-Export, kein Durchklicken im Admin. Ein Satz, fertig.

Was das Toolkit technisch macht

Im Kern besteht das Toolkit aus 16 Agent Skills, die jeweils einen Bereich von Shopify abdecken. Jeder Skill hat Zugriff auf die aktuelle Shopify-Dokumentation, kann Code gegen die echten API-Schemas validieren und Änderungen über die Shopify CLI direkt am Store ausführen.

Der Ablauf ist immer derselbe: Der Agent sucht zuerst in der aktuellen Doku, schreibt dann den Code, validiert ihn gegen Shopifys Schemas und versucht bei Fehlern bis zu drei Mal nachzubessern. Erst wenn die Validierung durchgeht, wird der Code ausgeführt. Das klingt nach einem kleinen Detail, ist aber der entscheidende Unterschied zu normalem KI-generierten Code. Der Agent rät nicht, er arbeitet gegen die echte API.

Die 16 Skills im Überblick

API & Daten

Admin API ist der Hauptzugang. Produkte anlegen, Bestellungen verwalten, Kunden bearbeiten. Dazu kommt Admin Execution, das die validierten Queries direkt am Live-Store ausführt. Custom Data kümmert sich um Metafields und Metaobjects, also alles, was über die Standard-Felder hinausgeht: Nährwerttabellen, Lieferzeiten, Größenguides. Storefront API und Customer Account API sind für Headless-Storefronts und Kundenportale gedacht. Für Agenturen gibt es die Partner API, für Zahlungsintegrationen die Payments Apps API.

Theme & Liquid

Der Liquid-Skill deckt das komplette Theme-Development ab. Sections, Blocks, Snippets, Layouts, alles mit Schema-Validierung. Heißt: Der Agent schreibt nicht nur Liquid-Code, er prüft, ob der Code auch zu Shopifys Section-Schema passt.

Backend-Logik

Shopify Functions sind der spannendste Teil für Händler, die Custom-Logik brauchen. Rabattstaffeln, die sich nicht über den Admin abbilden lassen. Cart-Validierung, die bestimmte Produktkombinationen verhindert. Versandregeln, die nach Gewicht, Region oder Produkttyp filtern. Payment Customization, die Zahlungsarten je nach Warenkorb ein- oder ausblendet. Alles Sachen, für die man bisher eine App oder einen Entwickler brauchte.

UI Extensions

Fünf Skills für verschiedene Oberflächen: Admin-Extensions für Custom-Widgets auf Produkt- oder Bestellseiten. Checkout-Extensions für Upsells, Geschenkoptionen oder Custom Fields im Checkout. Customer-Account-Extensions fürs Kundenportal. Und POS-UI für Retail-Apps am Ladentisch.

Was sich für Händler ändert

Bis gestern sah die Arbeitsteilung so aus: Händler klicken im Admin, Entwickler schreiben Code. Das Toolkit verschiebt diese Grenze. Ein paar Beispiele, was jetzt per Prompt geht:

Vorher (manuell) Jetzt (per Prompt)
SEO-Titel manuell im Admin anpassen "Optimiere Titel und Meta-Description für Produkt X"
Rabatte per CSV oder einzeln setzen "Reduziere Produkte um 20%, die sich in der Kollektion Sommerprodukte befinden"
Theme-Anpassung = Agentur beauftragen "Füge eine Trust-Badge-Section unter Add-to-Cart ein"
Metafields = Doku lesen, App kaufen "Erstelle ein Metafield für Lieferzeit pro Produkt"
Checkout anpassen = Extension bauen "Zeige ein Geschenkverpackungs-Feld im Checkout"
Versandregeln = Settings durchklicken "Sperre Expressversand für Produkte über 30kg"
Discount-Logik = Script Editor / App "Kaufe 3, zahle 2 – aber nur für Collection X"
Bilder ohne Alt-Text finden "Setze SEO-Alt-Texte für alle Produktbilder"
Übersetzungen = Agentur oder Tool "Übersetze alle Produkttexte ins Französische"

Das ist beeindruckend. Und genau hier wird es auch heikel.

Wo es gefährlich wird

Das Toolkit validiert, ob der Code syntaktisch korrekt ist. Es prüft nicht, ob das Ergebnis kaufmännisch Sinn ergibt.

Kein Undo bei Store Execution. shopify store execute ändert den Live-Store. Falsch geprompted, und 500 Produkte haben kaputte Titel. Oder Preise. Oder beides. Shopify hat keinen Staging-Modus für API-Mutations. Was rausgeht, ist live.

SEO ist mehr als Meta-Titles. „Optimize all my products for SEO" klingt gut. Aber was kommt raus? Wenn der Agent alle 200 Produkte mit dem gleichen Muster betitelt, habt ihr Duplicate Content. Ohne Keyword-Recherche, ohne Suchintention, ohne Blick auf die Konkurrenz ist das Ergebnis bestenfalls mittelmäßig.

Noch heikler wird es bei Shopify Functions: Cart Validation, Delivery Rules, Payment Customization. Ein falscher Prompt, und der Checkout blockt zahlende Kunden. Oder die Rabattstaffel frisst die Marge, weil niemand gegengerechnet hat.

Und generell: Der Agent ist so gut wie der Prompt. Wer nicht weiß, was ein Metafield von einem Metaobject unterscheidet, wird Ergebnisse bekommen, die technisch funktionieren, aber strukturell keinen Sinn ergeben.

Warum ihr trotzdem eine Agentur braucht

Wir nutzen das Toolkit selbst. Es macht uns schneller, aber nicht überflüssig.

Wir wissen, welche Prompts man schreibt und in welcher Reihenfolge. Was man auf dem Live-Store testet und was besser zuerst auf einem Development-Store läuft. Und wir sehen, wie SEO-Titel, Metafields, Structured Data, Theme-Sections und Checkout-Extensions zusammenspielen müssen, damit am Ende auch die Conversion stimmt.

Das Toolkit ist das Werkzeug. Wir sind die, die damit umgehen können, ohne euren Shop zu zerlegen.

Ihr könnt es selbst probieren. Oder ihr lasst uns ran, und es sitzt beim ersten Mal.

Für wen sich das Toolkit lohnt

Für Händler mit technischem Verständnis, die wissen, was sie tun, ist das Toolkit ein riesiger Hebel. Kleine Anpassungen am Theme, Metafields anlegen, Produkte in Bulk bearbeiten. Dafür braucht ihr keine Agentur mehr, und das ist auch gut so.

Für alles, wo es um Logik geht, um Checkout-Flows, Rabattregeln, SEO-Strategie oder Performance, wird es schnell komplex. Und komplex auf einem Live-Store ohne Undo ist die Sorte Problem, bei der man sich Hilfe holt.

Einrichtung: Kein One-Click-Setup

Bevor ihr loslegen könnt, braucht ihr einiges an Vorbereitung. Und die ist weniger trivial, als es klingt.

Voraussetzungen

  • Node.js 20.10+ (nicht 18, wie manchmal genannt, die Shopify CLI braucht mindestens 20.10)

  • Git 2.28.0+

  • Shopify CLI 3.93.0+ (npm install -g @shopify/cli@latest)

  • Ein KI-Tool wie Claude Code, Cursor, VS Code Copilot oder Gemini CLI

Plugin installieren

Jedes KI-Tool bindet das Toolkit anders ein. In Claude Code sind es zwei Befehle in der CLI. In Cursor installiert ihr ein Plugin über den Marketplace. In VS Code geht es über die Command Palette. Für Gemini CLI ist es wieder ein anderer Befehl. Plug & Play ist das nicht: Ihr müsst wissen, wie euer Tool Plugins oder MCP-Server verwaltet, wo Konfigurationsdateien liegen und wie man sie anpasst.

Unsere Empfehlung: Cursor für alle, die eine grafische Oberfläche bevorzugen, oder die Shopify CLI direkt im Terminal für alle, die sich dort zu Hause fühlen. Beide Wege sind am besten dokumentiert und machen am wenigsten Probleme.

Store-Authentifizierung

Das ist der Teil, den viele unterschätzen. Bevor der Agent irgendetwas an eurem Shop ändern kann, müsst ihr euch authentifizieren und die richtigen Berechtigungen setzen:

shopify store auth --store euer-shop.myshopify.com --scopes write_products,read_products

Hinweis für Windows-Nutzer: In der PowerShell funktioniert die kommagetrennte Scope-Liste nicht. Dort müsst ihr jeden Scope einzeln anfragen, was den Prozess nochmal umständlicher macht.

Das öffnet einen OAuth-Flow im Browser. Der knifflige Teil sind die Scopes. Ihr müsst vorher wissen, welche Berechtigungen der Agent braucht. Produkte bearbeiten? write_products. Inventar? write_inventory. Bestellungen? read_orders. Es gibt Dutzende davon, und wenn der falsche Scope fehlt, schlägt die Query still fehl. Umgekehrt wollt ihr nicht pauschal alles freigeben. Das richtige Set an Scopes zusammenzustellen setzt voraus, dass ihr wisst, was ihr vorhabt und welche API-Endpunkte dafür nötig sind. Und selbst wenn ihr die richtigen Scopes anfragt, heißt das nicht, dass ihr sie auch bekommt: Je nach Store-Typ und eurer Rolle kann Shopify weniger Berechtigungen vergeben als angefragt. Die Meldung „Shopify granted fewer scopes than were requested" ist dann der Punkt, an dem viele nicht mehr weiterwissen. Läuft der Token ab, müsst ihr den Auth-Befehl erneut ausführen.

Alle Shopify Admin API Scopes (~95 Stück)
Bereich Read Write Beschreibung
Produkte read_products write_products Produkte & Collections
Inventar read_inventory write_inventory Lagerbestände
Bestellungen read_orders write_orders Bestelldaten
Alle Bestellungen read_all_orders Bestellungen > 60 Tage
Fulfillment read_fulfillments write_fulfillments Versandabwicklung
Zugewiesene Fulfillments read_assigned_fulfillment_orders write_assigned_fulfillment_orders Zugewiesene Aufträge
Händler-Fulfillments read_merchant_managed_fulfillment_orders write_merchant_managed_fulfillment_orders Eigene Aufträge
Drittanbieter-Fulfillments read_third_party_fulfillment_orders write_third_party_fulfillment_orders Externe Aufträge
Kunden read_customers write_customers Kundendaten
Kunden-Events read_customer_events Event-Tracking
Zahlungsmethoden read_customer_payment_methods Genehmigung nötig
Kunden mergen read_customer_merge write_customer_merge Zusammenführen
Rabatte read_discounts write_discounts Rabattkonfigurationen
Preisregeln read_price_rules write_price_rules Automatische Rabatte
Zahlungsanpassungen read_payment_customizations write_payment_customizations Checkout-Zahlungen
Content read_content write_content Blog, Artikel, Seiten
Themes read_themes write_themes Theme-Dateien
Shop-Seiten read_online_store_pages Statische Seiten
Navigation read_online_store_navigation write_online_store_navigation Menüs
Metaobjects read_metaobjects write_metaobjects Custom-Objekte
Metaobject-Definitionen read_metaobject_definitions write_metaobject_definitions Schemas
Versand read_shipping write_shipping Versandkonfiguration
Lieferanpassungen read_delivery_customizations write_delivery_customizations Delivery Rules
Zahlungsbedingungen read_payment_terms write_payment_terms B2B-Zahlungsziele
Streitfälle read_shopify_payments_disputes Payment Disputes
Auszahlungen read_shopify_payments_payouts Payout-Daten
Store Credit read_store_credit_accounts write_store_credit_account_transactions Guthaben
Märkte read_markets write_markets International
Standorte read_locations write_locations Fulfillment-Standorte
Übersetzungen read_translations write_translations Lokalisierung
Locales read_locales write_locales Sprachen
Entwurfsbestellungen read_draft_orders write_draft_orders Draft Orders
Dateien read_files write_files Medien & Dokumente
Geschenkkarten read_gift_cards write_gift_cards Gift Cards
Retouren read_returns write_returns Rücksendungen
Bestelländerungen read_order_edits write_order_edits Order Edits
Analytics read_reports Berichte
Marketing read_marketing_events write_marketing_events Kampagnen-Events
Script Tags read_script_tags write_script_tags Externe Scripts
Mitarbeiter read_users Shopify Plus
Web Pixels write_pixels Tracking-Pixels
Cart Transforms read_cart_transforms write_cart_transforms Warenkorb-Regeln
Checkout Branding read_checkout_branding_settings write_checkout_branding_settings Checkout-Design
Validierungen read_validations write_validations Cart/Checkout Rules
Richtlinien read_legal_policies AGB, Datenschutz etc.
Datenschutz read_privacy_settings write_privacy_settings Privacy-Optionen
App Proxy write_app_proxy Dynamische Daten

Erst dann: Store Execute

Wenn alles steht, kann der Agent validierte GraphQL-Queries per shopify store execute am Live-Store ausführen. Mutations (also Änderungen) brauchen zusätzlich das Flag --allow-mutations, eine bewusste Sicherheitshürde.

Insgesamt sind es mindestens fünf bis sechs Schritte, bis ihr tatsächlich per Prompt euren Shop steuern könnt. Kein Hexenwerk, aber auch kein Plug-and-Play. Die vollständige Anleitung findet ihr auf GitHub.

Fazit

Das Shopify AI Toolkit bringt KI-Automatisierung dahin, wo sie Händlern und Agenturen am meisten nützt: in den täglichen Umgang mit dem Shop. Produkte optimieren, Rabattlogik anpassen, Extensions bauen, alles validiert und direkt am Store. Vieles davon hat früher Entwicklerstunden gekostet.

Gleichzeitig bleibt der Shop ein Live-System. Wer promptet, ohne die Konsequenzen zu kennen, kann sich schnell in eine Situation manövrieren, die nicht mit einem weiteren Prompt zu lösen ist.

Wenn ihr das Toolkit ausprobieren wollt oder Unterstützung braucht, euren Shop damit richtig aufzusetzen: meldet euch bei uns. Wir arbeiten bereits damit und wissen, wo die Fallstricke liegen.

T

Tobias Graeger

Inhaber & Shopify-Entwickler

Tobias leitet alle Projekte persönlich. Mit über 50 abgeschlossenen Shopify-Projekten kennt er die Plattform vom Liquid-Template bis zur API-Integration. Sein Fokus: technisch saubere Lösungen, die mit dem Business mitwachsen.

LinkedIn

Beitrag teilen