eBay mit Claude sprechen zu lassen ist konzeptionell nicht schwierig. Es braucht eine OAuth-App, vier Werte und eine Berechtigungsliste. Schwierig ist, dass eBay diese Werte anders nennt als jeder andere Marktplatz und ein Feld etwas verlangt, das genau wie eine URL aussieht, aber keine ist.
Die vier Werte und ihre Namen bei eBay
App ID ist die Client-ID. Cert ID ist das Client-Secret. Beide stehen im eBay Developer Portal unter My Account → Application Keys und lassen sich einfach kopieren und einfügen.
RuName hält viele auf und erhält deshalb weiter unten einen eigenen Abschnitt.
Marketplace ID legt fest, auf welcher eBay-Website Sie arbeiten, und muss zu einer dort unterstützten Spracheinstellung passen. Meist ist das offensichtlich — bis es das nicht mehr ist. eBay schreibt für Malaysia und Singapur en-US vor. Genau solche Details entdeckt man eher durch eine Fehlermeldung als durch einen Leitfaden.
RuName ist ein Name, keine Adresse
Im Entwicklerportal gehen Sie zu Keyset → User Tokens → Get a Token via Your Application und erstellen oder öffnen einen Eintrag für eine Redirect URL. Darin setzen Sie „Your auth accepted URL“ auf die Callback-Adresse des Clients, den Sie verbinden. Orkas verwendet https://orkas.ai/api/connectors/oauth/dcr-callback; ein eigener Server ist dafür nicht nötig.
Dann — und das ist der entscheidende Schritt — kopieren Sie den RuName, den eBay für diesen Eintrag erzeugt hat. Es ist eine kurze, undurchsichtige Zeichenfolge neben der gerade eingegebenen URL. Das Feld dafür ist von URL-Feldern umgeben, weshalb man instinktiv wieder die URL einfügt. Damit klappt die Autorisierung nicht, und die zurückgegebene Fehlermeldung erklärt nicht, warum.
Die Sandbox ist keine Abkürzung
eBay betreibt eine Sandbox, für die nur ein kostenloses Entwicklerkonto nötig ist, kein einwandfreies Verkäuferkonto. Sie ist tatsächlich nützlich, um die API-Struktur kennenzulernen. Für das, was Sie eigentlich wollen — Ihre eigenen Angebote und Bestellungen —, ist sie nicht nützlich. Sandbox-Daten sind synthetisch.
Neue Verbindungen in Orkas verwenden ausschließlich die Produktivumgebung. Der zeitbestimmende Schritt ist daher der Antrag beim eBay Developers Program — eine App mit Berechtigungen für Verkäuferkonto, Bestand, Angebote und Auftragsabwicklung sowie deren Production Keyset —, nicht der anschließend gewählte Client. Beginnen Sie früh. Der offizielle Autorisierungsleitfaden lohnt sich während der Antragsbearbeitung.
Lesen ist nicht Schreiben
Sobald das Keyset vorhanden ist, entscheidet die Berechtigungsliste über den tatsächlichen Zweck der Verbindung. Zu fragen, was letzte Woche verkauft wurde, ist ein Lesezugriff. Ein Angebot überarbeiten, den Bestand anpassen oder eine Bestellung als versendet markieren ist ein Schreibzugriff und benötigt die entsprechenden Berechtigungen der App.
Mehrere gehostete Dienste zur Verbindung von eBay und Claude sind bewusst schreibgeschützt. Das ist ein sinnvolles Produkt — nur eben nicht dasselbe. Prüfen Sie die Schreibfunktionen, bevor Sie den Antragsaufwand investieren, denn der vorgelagerte Antrag ist in beiden Fällen identisch.
Der Orkas-Konnektor greift von Ihrem eigenen Rechner auf die produktiven Sell APIs zu. Zugangsdaten werden auf dem Gerät verschlüsselt, statt in einer Konfigurationsdatei oder auf fremden Servern zu liegen. Jeder Schreibzugriff auf ein aktives Konto durchläuft eine Berechtigungsabfrage im Client, statt auf die Vorsicht des Modells zu vertrauen.
Wann etwas anderes die bessere Antwort ist
Sie möchten nur Berichte: Ein gehosteter Konnektor erfordert weniger Einrichtung und keine Installation. Sie möchten einen geplanten Lauf ohne Aufsicht: Dies ist eine Desktop-Anwendung; das Schließen des Fensters stoppt sie. Ein geplanter Serverjob ist die passende Lösung. Sie lernen die API noch kennen: Nutzen Sie die Sandbox und ein kostenloses Entwicklerkonto und verbinden Sie noch nichts mit einem aktiven Konto.
Derselbe Katalog umfasst Etsy, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce und die chinesischen Plattformen. Das Jonglieren mit Zugangsdaten beginnt also nicht bei jedem Shop von vorn. Die benachbarten Artikel zu Etsy und Shopify behandeln dasselbe Thema für diese beiden Plattformen.