Zeigt, ob gerade eine gültige Etsy-Anmeldung besteht (ohne Tokens preiszugeben), inkl. Scope und Ablaufzeitpunkt.

Startet den OAuth-2.0-Login mit PKCE: öffnet die Etsy-Autorisierungsseite im Browser, empfängt den Callback lokal, prüft den state-Wert und speichert die Tokens sicher lokal. Fordert die Scopes shops_r, listings_r, transactions_r und listings_w an. listings_w allein aktiviert noch keine Schreibfunktion - dafür muss zusätzlich ETSY_WRITE_ENABLED=true lokal gesetzt sein.

Entfernt die lokal gespeicherten Etsy-Tokens. Eine erneute Anmeldung ist danach jederzeit möglich.

Liest Shop-Stammdaten von Etsy: Name, Titel, Ankündigung, Währung, Anzahl aktiver Listings, Favoriten, Bewertungsdurchschnitt, Urlaubsmodus-Status. Reine Fakten direkt von Etsy, keine Berechnung.

Listet alle Kategorien (Shop-Sections) des Shops mit Titel, Rang und Anzahl aktiver Listings darin.

Listet Listings des Shops auf, gefiltert nach Status (active/inactive/draft/expired/sold_out; ohne Angabe: nur aktive). Enthält Titel, Preis, Bestand, Tags, Zeitstempel je Listing. Maximal 100 Ergebnisse pro Aufruf (Etsy-Limit), Paginierung über 'offset'.

Liest die Detaildaten eines einzelnen Listings anhand seiner numerischen Listing-ID.

Liest Varianten (Products/Offerings), SKUs, Preise pro Variante und Bestand für ein Listing. Wichtig für Analysen zu fehlenden SKUs oder niedrigen Beständen.

Liest die Produktbilder eines Listings inklusive ihrer Reihenfolge (rank) und Bild-URLs.

Liest Bestellungen des Shops (Etsy nennt sie 'Receipts') für einen optionalen Zeitraum (max. 366 Tage), mit Paginierung (max. 100 pro Aufruf). Aus Datenschutzgründen werden Käufername, Adresse und Kontaktdaten NICHT zurückgegeben - nur Status, Land (grob), Summen und Zeitstempel.

Liest die einzelnen Kaufpositionen (Transaktionen) des Shops: welches Listing, welche SKU, welche Menge und welcher Preis pro Bestellung verkauft wurde. Enthält keine Käuferdaten (buyer_user_id wird herausgefiltert).

Sammelt Shop-, Listing- und Section-Daten und berechnet daraus objektive Kennzahlen (z.B. Preisspanne, Aufrufe, fehlende Shop-Section, kurze Titel, wenige Tags, mögliche Duplikate, fehlende SKUs, optional niedriger Bestand je Variante). Die Antwort trennt strikt zwischen 'fakten' (unverändert von Etsy), 'kennzahlen' (deterministisch berechnet) und enthält BEWUSST KEINE fertigen Empfehlungen - Interpretation und Handlungsempfehlungen sollen auf Basis dieser Rohdaten von Claude selbst formuliert werden.

Erstellt ein NEUES Listing IMMER als Entwurf (draft) - niemals direkt aktiv. Erfordert ETSY_WRITE_ENABLED=true. Standardmäßig dry_run:true (nur Vorschau). Für eine echte Erstellung: zuerst die Vorschau prüfen, dem Nutzer die geplanten Daten zeigen, dessen ausdrückliche Zustimmung einholen, dann erneut mit dry_run:false und confirm:true aufrufen.

Ändert Titel, Beschreibung, Materialien, Shop-Section, Kategorie oder Herstellungsangaben eines bestehenden Listings (NICHT Preis/Bestand/Tags/Status - dafür gibt es eigene Tools). Erfordert ETSY_WRITE_ENABLED=true. dry_run:true (Standard) zeigt nur die Vorschau (alt→neu).

Setzt die Tag-Liste (max. 13, je max. 20 Zeichen) für ein oder mehrere Listings gleichzeitig. Betrifft die Aktion mehr als ein Listing, ist zusätzlich confirm_bulk:true nötig (Sammelbestätigung), nachdem der Nutzer die vollständige Liste bestätigt hat. dry_run:true (Standard) zeigt alt→neu je Listing.

Ändert den Preis eines Listings - entweder einheitlich ('price') für alle Varianten, oder individuell je Variante ('variation_prices'). Erfordert IMMER eine Einzelbestätigung (confirm:true nach ausdrücklicher Nutzerzustimmung). dry_run:true (Standard) zeigt alt→neu je Variante.

Ändert den Lagerbestand (quantity) eines Listings - einheitlich ('quantity') oder individuell je Variante ('variation_quantities'). Erfordert IMMER eine Einzelbestätigung. dry_run:true (Standard) zeigt alt→neu je Variante.

Ersetzt die vollständige Varianten-/Angebotsstruktur (Products/Offerings inkl. SKU, Eigenschaften, Preis, Bestand) eines Listings - Experten-Tool für komplexere Änderungen (neue Variante hinzufügen, SKU-Schema umbauen etc.). Ersetzt IMMER die gesamte Struktur, keine Teil-Updates. Erfordert IMMER eine Einzelbestätigung. dry_run:true (Standard) zeigt aktuell vs. geplant im Vergleich.

Lädt ein lokal vorhandenes Bild (JPG/PNG/GIF, max. 10 MB) zu einem Listing hoch. Nur lokale Dateipfade, keine URLs (aus Sicherheitsgründen wird nichts von externen Quellen heruntergeladen). Erfordert IMMER eine Einzelbestätigung. dry_run:true (Standard) prüft nur Datei und zeigt die Vorschau.

Ändert die Anzeige-Reihenfolge (rank) bereits hochgeladener Bilder eines Listings, ohne sie neu hochzuladen. Erfordert IMMER eine Einzelbestätigung. dry_run:true (Standard) zeigt aktuelle vs. geplante Reihenfolge.

Setzt den Status von einem oder mehreren Listings auf "active". Betrifft die Aktion mehr als ein Listing, ist zusätzlich confirm_bulk:true nötig (Sammelbestätigung). dry_run:true (Standard) zeigt den aktuellen Status je Listing.

Setzt den Status von einem oder mehreren Listings auf "inactive". Betrifft die Aktion mehr als ein Listing, ist zusätzlich confirm_bulk:true nötig (Sammelbestätigung). dry_run:true (Standard) zeigt den aktuellen Status je Listing.