Headless Commerce · einlesen Medusa

Medusa Commerce mit Photopilot ergänzen

Produkte, Varianten und Bilder aus Medusa einlesen.

Import über Medusa-API + Export
Export über FTP, Excel oder API

Demo planen Probieren Sie es selbst

DSGVO-konform, Daten in der EU
SLA und ein fester Ansprechpartner
Verbindet sich mit Shopware, Shopify und Ihrem ERP
13 Händler und Marken in Produktion

Medusa

So verläuft die Route

Sie erstellen in Medusa ein API-Token.
Photopilot liest Produkte, Varianten, Metadaten und Bilder ein.
Bilder und Texte werden anhand von SKU oder handle dem richtigen Artikel zugeordnet.
Die Ausgabe geht per FTP, über die Webshop-Excel oder über die API an Ihre Veröffentlichungsebene.

Sehen Sie, was hereinkommt und passt Konflikte bleiben für Ihr Team sichtbar.

Erklärung

So funktioniert Photopilot mit Medusa

Mit Medusa baut ein Team seinen eigenen Commerce-Stack, und Produktcontent sollte nicht von Releases abhängen. Photopilot liest Produkte, Varianten, Metadaten und Bilder aus Medusa aus, übernimmt die Bild- und Textarbeit und liefert das Ergebnis so an, dass Ihr eigenes Modul oder Ihr Import es verarbeitet. So arbeitet das Contentteam in einem festen Rhythmus weiter, unabhängig von der Sprintplanung.

Was Photopilot aus Medusa abruft

Über die Admin API liest Photopilot Produkte mit Titel, Handle, Status, Metadaten, Thumbnail und Bildern. Pro Variante werden SKU, Titel, Bestand und eigene Metadaten übernommen. Wer lieber die Store API nutzt, kann auch mit einem publishable API key anbinden. Jeder Durchlauf ruft nur Produkte ab, die seit dem letzten Mal aktualisiert wurden.

Abgleich nach SKU, handle und EAN

Photopilot verknüpft Bilder über SKU, handle und eine EAN aus den Metadaten der Variante oder des Produkts mit Medusa-Produkten. Steht eine eigene Produktnummer in den Metadaten, verwenden wir sie als Hauptschlüssel. Lieferantenbilder, die per EAN oder Artikelnummer eingehen, finden so automatisch den Weg zum richtigen Produkt. Varianten mit derselben Farbe teilen sich dabei ein Bildset.

Bild und Text in Photopilot

Supplier images und Packshots werden in Photopilot korrigiert: freigestellt, zugeschnitten und auf den Hintergrund gesetzt, den Ihre Storefront verwendet. Wo ein Modelfoto fehlt, erstellt Photopilot AI-Modelfotos oder eine Ghost Mannequin, und mit Iris als AI Creative Director entstehen Kampagnenbilder im Corporate Design. Materialien und Pflegesymbole werden erkannt und in Produkttexte und SEO-Texte übernommen. Das Content-Team prüft und genehmigt jedes Produkt.

Zurück in Medusa über Ihr eigenes Modul

Freigegebene Bilder und Texte ruft ein Subscriber, scheduled job oder eigenes Modul über die Photopilot-API ab, oder sie stehen auf FTP/SFTP und in der Webshop-Excel bereit. Pro Produkt ist die Bildreihenfolge festgelegt, einschließlich welches Bild zum thumbnail wird, und jedes Bild hat einen Alt-Text. Texte und SEO-Felder werden pro Produkt und Sprache mitgeliefert. Da sich das Lieferformat nicht ändert, muss die Verarbeitung nur einmal entwickelt werden.

Content unabhängig von Development-Releases

In vielen Medusa-Projekten steht Produktcontent im selben Backlog wie Features, sodass eine neue Kollektion auf ein Release wartet. Mit Photopilot wandert diese Arbeit zum Contentteam: Neue Produkte erscheinen automatisch in der Arbeitsliste, und die Übersicht fehlender Bilder zeigt, wo Handlungsbedarf besteht. Mit Autopilot laufen feste Schritte wie Freistellen und Zuschneiden ohne manuelle Arbeit durch. Auswertungen zeigen, wie vollständig der Katalog ist.

Schnell eingerichtet, ohne IT-Projekt

Sie geben uns die URL des Medusa-backend und ein API-token mit Leserechten für Produkte oder einen publishable API key für die Store API. Gemeinsam legen wir fest, welche Metadaten-Schlüssel EAN, Farbe und Material enthalten und wie Ihr Modul die Ausgabe abruft. Der erste Durchlauf läuft direkt mit Ihren eigenen Produkten. Danach liest Photopilot standardmäßig alle zwei Stunden nach.

Medusa auf einen Blick

Was ausgetauscht wird: Über die Medusa-API liest Photopilot Produkte, Varianten mit SKU, Metadaten und Bilder ein. Photopilot schreibt nicht in Medusa.
Wie oft: Standardmäßig alle zwei Stunden. Photopilot liest nur die Produkte ein, die seit dem letzten Durchlauf in Medusa aktualisiert wurden.
Was Sie bereitstellen: Die URL der Medusa-API und ein API-Token mit Leserechten für Produkte.
Gut zu wissen: Die Anbindung wurde in unserem Testlabor mit einer echten Medusa-Installation getestet.

Danach in Photopilot

Zuverlässig verbunden

Quelldaten bis zu verkaufsfertigen Produktseiten durchlaufen lassen

300.000+ Artikel verarbeitet

9,5M+ Lieferantenbilder indexiert

~3.200 Fotos pro Tag automatisch bearbeitet

FAQ

Häufig gestellte Fragen

Wie verbinde ich Medusa mit Photopilot?

Teilen Sie die URL Ihres Medusa-Backends und ein API-Token mit Leserechten für Produkte. Danach liest Photopilot Produkte, Varianten, Metadaten und Bilder über die Admin API ein.

Kann Photopilot auch über die Store API von Medusa lesen?

Ja, mit einem publishable API key liest Photopilot die Produkte über die Store API aus. Das ist praktisch, wenn Sie kein Admin-Token herausgeben möchten.

Wie gelangen Produktbilder aus Photopilot in Medusa?

Ein eigenes Modul, ein Subscriber oder ein geplanter Job ruft die freigegebenen Bilder über die Photopilot-API oder per FTP/SFTP ab. Die Reihenfolge und das Thumbnail sind pro Produkt festgelegt, sodass die Verarbeitung einfach ist.

Anhand welcher Felder gleicht Photopilot Medusa-Produkte ab?

Anhand von SKU, handle und einer EAN aus den Metadaten der Variante oder des Produkts. Eine eigene Produktnummer in den Metadaten kann als Hauptschlüssel dienen.

Funktioniert Photopilot mit Farb- und Größenvarianten in Medusa?

Ja. Photopilot liest alle Varianten mit SKU und Bestand ein und gruppiert Bilder pro Farbe, sodass Größen derselben Farbe ein gemeinsames Bildset verwenden.

Muss ich für Photopilot ein Medusa-Plugin installieren?

Für das Einlesen nicht, ein API-Token reicht. Für das Zurückschreiben verarbeitet Ihr eigenes Modul die feste Lieferung von Photopilot.

Kann ich Bilder und Texte freigeben, bevor sie in Medusa landen?

Ja. Alles steht zunächst in Photopilot zur Prüfung bereit, und nur freigegebener Content wird geliefert. Pro Produkt sehen Sie, was neu ist oder geändert wurde.

Was passiert, wenn ein Medusa-Produkt kein Foto vom Lieferanten hat?

Dann steht er in der Übersicht mit fehlenden Bildern. Aus einem einfachen Produktfoto erstellt Photopilot einen Packshot, ein Ghost-Mannequin-Bild oder AI-Modelfotos, die Sie zuerst prüfen.

Was kosten KI-Model-Fotos für einen Medusa-Onlineshop?

KI-Fotos kosten zum Warteschlangenpreis 0,05 € bis 0,21 € pro Foto und sind oft innerhalb einer Stunde fertig. Ein eigenes KI-Model mit festem Gesicht kostet 1,37 €.

Wie oft liest Photopilot aus Medusa ein?

Standardmäßig alle zwei Stunden, jeweils nur die in Medusa aktualisierten Produkte.

Was benötigt Photopilot, um Medusa anzubinden?

Die URL der Medusa-API und ein API-Token mit Leserechten für Produkte.

Wohin geht der Output von Photopilot?

Über FTP/SFTP, die Webshop-Excel oder die API zu Ihrer Veröffentlichungsebene. Direktes Zurückschreiben in Medusa macht Photopilot nicht.

Wissensdatenbank

Lesen Sie auch

So starten Sie

Zuerst die Teststrecke, dann die Technik

Die Integration ist der Ausgangspunkt. Danach hält Photopilot das Verbinden, Bearbeiten, Schreiben, Kontrollieren und Veröffentlichen zusammen.