Ein Befehl, ein fertiger Monats-Report.
Shopify, GA4, Search Console, PageSpeed und die AI-Suche liegen in fünf verschiedenen Oberflächen. ptai-ecom holt sie zusammen und legt daraus einen Monats-Report als PDF ab, inklusive Vormonats-Vergleich und priorisierten Maßnahmen. Kein Dashboard, keine Datenbank, kein Abo.
⬇ In Claude Code installieren
Zwei Befehle, direkt in Claude Code eingefügt. Danach stehen alle acht Skills bereit.
Schritt 1 · Marketplace hinzufügen
Schritt 2 · Plugin installieren
Quelle und Doku: github.com/yves-s/ptai-ecom. Updates kommen über /plugin nach, ohne Neuinstallation.
Das Plugin ist die Reporting-Schicht, mit der ich meine eigenen Kunden fahre. Es liegt offen, weil ein Report, den du selbst ziehen kannst, mehr wert ist als einer, den du monatlich anfragen musst.
Was im Report steht
Sechs Kapitel, immer dieselbe Reihenfolge, jede Zahl mit Vormonats-Vergleich.
Executive Summary
Acht KPI-Kacheln in zwei Reihen. Umsatz, Bestellungen, Warenkorbwert und Sessions stehen fest, die zweite Reihe wählt der Monat. Der Monat ist verstanden, bevor der erste Satz gelesen ist.
Shop
Umsatz, Bestellungen, AOV, Sessions und Conversion Rate aus Shopify, dazu der session-basierte Micro-Funnel von der Produktansicht bis zum Warenkorb. Die schwächste Übergangsstufe wird markiert.
Traffic
Kanäle, Landingpages und Conversion Rate je Kanal aus GA4. Zeigt, welcher Kanal Besuche liefert und welcher davon tatsächlich kauft.
SEO
Klicks, Impressionen, Position und CTR aus der Search Console, Queries kurz vor Seite eins, CTR-Lücken auf gut platzierten Seiten, dazu die Core Web Vitals aus echten Nutzerdaten.
GEO
Wie oft die Marke in den Antworten von Google AI, ChatGPT und Perplexity auftaucht, getrennt nach Marken- und Kategorie-Fragen, plus die Crawler-Matrix aus robots.txt und der llms.txt-Status.
Maßnahmen
Drei bis sieben Punkte, priorisiert. Jede Maßnahme hängt an einem Befund aus den Kapiteln davor, keine allgemeinen Empfehlungen.
Das PDF kommt im Path-to-AI-Layout, mit eingebetteten Fonts und ohne Netzzugriff beim Rendern. Daneben liegt der gleiche Report als Markdown, falls du ihn weiterverarbeiten willst.
Woher die Zahlen kommen
Fünf Quellen, alle über ihre offiziellen APIs, alle im Free-Tier nutzbar.
Shop
Was der Shop tatsächlich umgesetzt hat.
- Shopify: Umsatz, Bestellungen, AOV
- Sessions, Top-Produkte, Bestand
- Abandoned Checkouts, Kundentyp
Traffic & SEO
Wer kommt, woher, und über welche Suche.
- GA4: Kanäle, Landingpages, Funnel
- Search Console: Queries, Seiten, Position
- PageSpeed Insights: Core Web Vitals
AI-Sichtbarkeit
Ob die Marke in AI-Antworten vorkommt.
- Google AI, ChatGPT, Perplexity
- Citation Rate und Share of Voice
- Crawler-Matrix und llms.txt
Fehlt eine Quelle, blockiert das nichts. Sie steht im Report als „nicht verfügbar“ mit Grund, der Rest läuft. Du kannst also mit Shopify allein anfangen und GA4 später anschließen.
Die acht Skills
Jede Skill läuft auch einzeln, report und pulse rufen die anderen der Reihe nach auf.
| Skill | Was sie macht |
|---|---|
/ptai-ecom:setup | Geführter Anschluss-Wizard: prüft die Umgebung, führt durch jede fehlende Quelle, schreibt die Config. Jederzeit wieder aufrufbar. |
/ptai-ecom:report | Monats-Report: zieht alle Quellen, vergleicht gegen den Vormonat, schreibt Markdown und rendert das PDF. |
/ptai-ecom:pulse | Wochen-Puls: KPI-Tabelle gegen die Vorwoche, kommentiert nur, was auffällt. |
/ptai-ecom:pull-shopify | Shopify-Snapshot: Umsatz, Bestellungen, AOV, Sessions, Top-Produkte, Bestand. |
/ptai-ecom:pull-ga4 | GA4-Snapshot: Kanäle, Landingpages, E-Commerce-Funnel. |
/ptai-ecom:pull-gsc | Search-Console-Snapshot: Top-Queries, Top-Seiten, Indexierung. |
/ptai-ecom:pull-cwv | Core Web Vitals über PageSpeed Insights, Feld- und Labordaten. |
/ptai-ecom:check-geo | AI-Sichtbarkeit über die Plattform-APIs, dazu Crawler-Matrix und llms.txt-Status. |
Was du brauchst
Claude Code auf deinem Rechner. Dort laufen alle Skills.
Installation und Login: docs.claude.com/claude-code
Lesezugriff auf deine Quellen. Für GA4 und Search Console ein Google-Service-Account, für den Shop ein Shopify-Auth-Grant, für Core Web Vitals ein kostenloser PageSpeed-Key. Die drei GEO-Keys sind optional.
Nichts davon musst du vorab besorgen. Der Setup-Wizard zeigt, was fehlt, und führt Schritt für Schritt durch jeden Anschluss, bis der Haken auf OK springt.
Ein paar Standard-Tools: python3 mit google-auth und requests, dazu jq und curl. Für das PDF Chrome oder Chromium, für den Shopify-Pull die Shopify CLI.
Der Wizard prüft alles in einem Durchlauf und zeigt eine Haken-Liste, bevor irgendetwas eingerichtet wird.
So läuft ein Monat
Einmalig
Einrichten
Im Ordner, in dem das Reporting liegen soll:
Der Wizard fragt Marke, Domain, Property-IDs und die Fragen ab, mit denen die AI-Sichtbarkeit geprüft wird, und legt die Config an. Am Ende bietet er den ersten Report direkt an.
Jeden Monat
Report ziehen
Default ist der letzte volle Monat. Willst du einen anderen, sag es einfach dazu:
Zieh mir den Monats-Report für Juni 2026.
Der Lauf holt jede aktive Quelle, vergleicht gegen den gespeicherten Vormonats-Stand und legt Markdown und PDF nebeneinander ab. Dauert je nach Quellen ein paar Minuten.
Jede Woche
Puls checken
Eine KPI-Tabelle gegen die Vorwoche, ohne Kapitel und ohne PDF. Kommentiert wird nur, was auffällt.
Was nicht passiert
- Kein Schreiben in deine Systeme. Alle Skills lesen nur, es gibt keinen Weg zurück in Shop, GA4 oder Search Console.
- Keine Daten bei mir. Snapshots, Reports und Zugänge bleiben auf deinem Rechner. Path to AI sieht nichts davon.
- Keine Infrastruktur. Keine Datenbank, kein Hintergrunddienst, kein Abo. Historie liegt als JSON-Dateien im Ordner.
- Keine erfundenen Zahlen. Jede Zahl im Report stammt aus einem konkreten Feld eines Snapshots. Fehlt eine Quelle, steht das da, statt geschätzt zu werden.
AI-Operator
Zahlen sind der Anfang, nicht das Ergebnis.
Den Report kannst du ab jetzt selbst ziehen. Die Maßnahmen darin umzusetzen ist der eigentliche Teil, und genau den übernehme ich: operative AI-gestützte Umsetzung von SEO und GEO über bezahlte Suche bis zur Conversion, mit einem Agenten-System pro Disziplin und ohne zusätzlichen Headcount.
Gespräch vereinbaren → Oder bau dir den kompletten E-Com-Audit selbst →ptai-ecom steht unter der MIT-Lizenz: nutzen, ändern, weitergeben, auch kommerziell, ohne Gewähr. Ausgenommen bleiben die mitgelieferten Fonts (Fraunces, Inter, JetBrains Mono, SIL Open Font License 1.1) und das Path-to-AI-Logo. Das Plugin läuft mit deinen eigenen API-Zugängen auf deinem Rechner; für die Nutzungsbedingungen von Shopify, Google und den AI-Plattformen bist du selbst verantwortlich.