Zusammenfassung
Salsify PXM API für eine Organisation: Produkte und deren Eigenschaftswerte, digitale Assets, Eigenschaftsdefinitionen, Listenmitgliedschaften, Exporte, Importabläufe und Kanalabläufe. API-Schlüssel (Bearer) und Organisations-ID.
Geführte Einrichtung
Salsify in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Salsify in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Salsify
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Salsify, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Salsify
Salsify PXM API für eine Organisation: Produkte und deren Eigenschaftswerte, digitale Assets, Eigenschaftsdefinitionen, Listenmitgliedschaften, Exporte, Importabläufe und Kanalabläufe. API-Schlüssel (Bearer) und Organisations-ID.
Einrichtung
Die Einrichtung dauert etwa 3 Minuten.
- Melde dich bei Salsify an (idealerweise als dedizierter Integrationsbenutzer mit nur den benötigten Rechten) und öffne dein Profil, API-Zugriff (https://app.salsify.com/app/profile/edit/api). Kopiere den API-Schlüssel (generiere einen, wenn er leer ist) in
SALSIFY_API_TOKEN. Er agiert mit den Berechtigungen dieses Benutzers und bleibt gültig, bis er regeneriert wird. - Kopiere die Organisations-ID aus der Adresszeile: den Teil nach
/orgs/, beginnend mits-(zum Beispiels-1a2b3c4d-...). Füge sie inSALSIFY_ORG_IDein.
Der API-Zugriff hängt von deiner Salsify-Lizenz ab; frage deinen Salsify-Kontakt, wenn im Profil kein API-Schlüssel angezeigt wird. Das Token wird als Bearer-Token gesendet.
Wo du anfangen kannst: salsify_list_products (mit einem Filter oder ohne für alle) und salsify_get_product für ein Produkt. Die Eigenschafts-IDs sind die Schlüssel, die du bei Produkten siehst; salsify_get_property erklärt eine.
Produkte: salsify_list_products, salsify_get_product, salsify_create_product, salsify_update_product. Werte sind nach Eigenschafts-ID zugeordnet (zum Beispiel Brand, Product Name); eine mehrwertige Eigenschaft nimmt eine Liste; null löscht einen Wert. Unbekannte Eigenschafts-IDs werden als Text-Eigenschaften erstellt, also überprüfe die Schreibweise. salsify_upsert_products (Bulk) und salsify_delete_product sind standardmäßig deaktiviert.
Digitale Assets: salsify_list_digital_assets, salsify_get_digital_asset, salsify_create_digital_asset (von einer öffentlichen URL; im Hintergrund verarbeitet), salsify_update_digital_asset. Verlinke ein Asset zu einem Produkt, indem du die Asset-Eigenschaft des Produkts auf die Asset-ID setzt.
Eigenschaften und Listen: salsify_get_property, salsify_add_list_members, salsify_remove_list_members. Es gibt keinen dokumentierten Aufruf, um jede Eigenschaft aufzulisten: exportiere mit dem Attribut entity_type.
Exporte und Importe: salsify_start_export dann salsify_get_export, bis abgeschlossen; die URL ist ein temporärer Link zur Datei. salsify_get_import_run liest einen Importablauf; salsify_start_import_run (führt einen konfigurierten Import aus, möglicherweise über viele Produkte) ist deaktiviert.
Kanäle: salsify_get_latest_channel_run und salsify_get_channel_run zeigen den Status und den Feed-Link eines Kanals; salsify_start_channel_run ist deaktiviert, da ein Ablauf an einen Einzelhändler veröffentlicht werden kann. Die Kanalrouten werden von Salsifys eigenen Integrationen verwendet, sind jedoch nur teilweise in der öffentlichen Referenz beschrieben.
Filter: Salsify-Filter-Sprache: ='Brand':'Acme' (gleich), ='Product Name':^'Mug' (beginnt mit), ='Price':>'10', =list:12345 (Listenmitglieder); Bedingungen mit einem Komma für AND verbinden. Eigenschaftsnamen und Werte stehen in einfachen Anführungszeichen.
Seiten und Limits: Seite von 1 und per_page bis zu 100; meta.total_entries gibt die Gesamtzahl an. Die Paginierung stoppt beim 10.000. Ergebnis (422): Verwende einen Export für größere Mengen. Die Organisation kann 10.000 Anfragen pro Stunde über alle ihre Benutzer hinweg stellen (429 darüber; Header x-ratelimit-remaining und x-ratelimit-reset). Fehler werden als 422 mit einer Fehlerliste angezeigt; 401 bedeutet, dass der API-Schlüssel falsch ist; 400 mit einer Liste von Organisationen bedeutet, dass die Organisations-ID fehlt oder falsch ist.
Voraussetzungen: SALSIFY_ORG_ID, SALSIFY_API_TOKEN
Installiere den Connector lokal
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Öffne http://localhost:3000/connectors/store, wähle Salsify und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
salsify_list_products | Listet Produkte auf, optional eingegrenzt durch einen Salsify-Filter: jeden Eigenschaftswert jedes Produkts als Paare von Eigenschafts-ID und Wert, plus System… |
salsify_get_product | Holt ein Produkt anhand seiner Produkt-ID: alle Eigenschaftswerte (Paare von Eigenschafts-ID und Wert, Listen für mehrwertige Eigenschaften), Systemfelder… |
salsify_create_product | Erstellt ein Produkt aus Paaren von Eigenschafts-ID und Wert; die Produkt-ID-Eigenschaft ist erforderlich. Eine Eigenschafts-ID, die noch nicht existiert, wird als… |
salsify_update_product | Aktualisiert die Eigenschaftswerte eines Produkts: nur die gesendeten Eigenschaften ändern sich; jeder gesendete Wert ersetzt den gespeicherten, null entfernt ihn.… |
salsify_upsert_products | Erstellt oder aktualisiert bis zu 100 Produkte in einem Aufruf aus einer Liste von Objekten mit Eigenschaftswerten (jedes mit der Produkt-ID-Eigenschaft). Antwortet mit den… |
salsify_delete_product | Löscht ein Produkt dauerhaft mit seinen Eigenschaftswerten. Kann nicht rückgängig gemacht werden. Standardmäßig deaktiviert |
salsify_list_digital_assets | Listet digitale Assets (Bilder, Videos, Dokumente) auf, optional eingegrenzt durch einen Filter: salsify:id, salsify:name, salsify:url, salsify:format… |
salsify_get_digital_asset | Holt ein digitales Asset: salsify:id, salsify:name, salsify:url (Download-Link), salsify:format, salsify:bytes, salsify:status (in_progress… |
salsify_create_digital_asset | Fügt ein digitales Asset von einer öffentlichen URL hinzu; Salsify lädt es im Hintergrund herunter (salsify:status in_progress, dann abgeschlossen). Optionale ID… |
salsify_update_digital_asset | Aktualisiert ein digitales Asset: benutzerdefinierte Metadaten, salsify:name oder salsify:source_url, um die Datei zu ersetzen (was einen neuen Link erstellt). Nur die… |
salsify_get_property | Holt eine Eigenschaft (Attribut) Definition: salsify:id, salsify:name, salsify:data_type (string, rich_text, number, date, boolean, enumerated… |
salsify_add_list_members | Fügt Produkte (oder andere Entitäten) einer bestehenden Salsify-Liste anhand ihrer IDs hinzu. Die Listen-ID ist die Nummer in der Listen-URL in Salsify |
salsify_remove_list_members | Entfernt Produkte (oder andere Entitäten) aus einer Salsify-Liste. Die Produkte selbst bleiben |
salsify_start_export | Startet eine Exportdatei von Produkten, digitalen Assets, Eigenschaften (Attribut), enumerierten Werten (attribute_value) oder allem (all). Gibt… |
salsify_get_export | Holt den Status eines Exportablaufs: Status (laufend, abgeschlossen, fehlgeschlagen), Fortschritt, geschätzte verbleibende Zeit, Fehlerursache und, sobald… |
salsify_start_import_run | Führt einen Import aus, der bereits in Salsify konfiguriert ist (zum Beispiel einen JSON- oder CSV-Import von einem Mount-Punkt). Er kann viele Produkte ändern… |
salsify_get_import_run | Holt den Status eines Importablaufs: Status (laufend, abgeschlossen, fehlgeschlagen, abgebrochen, gestoppt), Fortschritt und Fehler. Poll nicht mehr als alle 15… |
salsify_get_latest_channel_run | Holt den neuesten Ablauf eines Kanals (einen Produktfeed oder eine Veröffentlichung an einen Einzelhändler oder eine Website): ID, Status (laufend, abgeschlossen, fehlgeschlagen), Zeitstempel… |
salsify_get_channel_run | Holt einen Ablauf eines Kanals: Status, Zeitstempel und product_export_url, sobald abgeschlossen |
salsify_start_channel_run | Startet einen neuen Ablauf eines Kanals, der seinen Feed regeneriert und, für veröffentlichende Kanäle, ihn an den Einzelhändler oder die Website sendet. Standardmäßig deaktiviert… |
Beispielaufforderungen
- "Welche Salsify-Produkte der Marke Northwind haben keinen Produktnamen?"
- "Zeige Produkt 00012345678905 mit seinen Eigenschaftswerten."
- "Starte einen Export der Liste Holiday Catalog und sag mir, wenn er bereit ist."
- "Wann hat der letzte Kanalablauf unseres Einzelhändlerkanals geendet, und mit welchen Fehlern?"
- "Füge die Produkte 00012345678905 und 00012345678912 der Liste Spring Launch hinzu."
Nächste Schritte
War dieser Guide hilfreich?