Der eBay MCP-Server — gib Claude, Cursor und jedem KI-Assistenten vollen Zugriff auf die Sell-APIs von eBay. 299 Tools für Bestand, Bestellungen, Marketing und Analytik, lokal ausgeführt mit deinen eigenen Schlüsseln.
Inoffizielles Open-Source-Projekt — ohne Zugehörigkeit, Genehmigung oder Billigung durch eBay Inc.
English · 简体中文 · Español · Português (BR) · 日本語 · 한국어 · Français · Deutsch · Русский
Hinweis: Die englische README.md ist die Quelle der Wahrheit für aktuelle Produktangaben (Tool-Familien, API-Stilllegungen, Versionshinweise). Diese Übersetzung kann hinterherhinken.
eBay MCP ist ein lokaler Model-Context-Protocol-Server, der KI-Assistenten —Claude Desktop, Claude Code, Cursor, Cline, Windsurf, Zed, Continue.dev, Roo Code und Amazon Q— direkt mit den Sell-APIs von eBay verbindet. Er stellt 299 Tools bereit, die 100% der eBay-Sell-API-Oberfläche (270 eindeutige Endpunkte) abdecken — für Bestandsverwaltung, Auftragsabwicklung, Marketing mit beworbenen Angeboten, Analytik und Entwicklerwerkzeuge. Alles läuft auf deinem Rechner über STDIO oder lokales HTTP — kein Cloud-Relay, und deine eBay-Zugangsdaten verlassen niemals deinen Computer.
Haftungsausschluss: Inoffizielles Drittanbieterprojekt — ohne Zugehörigkeit zu oder Billigung durch eBay Inc. Bereitgestellt „wie besehen“, ohne Gewährleistung. Du bist selbst dafür verantwortlich, die eBay-API-Lizenzvereinbarung und die Anforderungen an die Datenverarbeitung einzuhalten, deine Zugangsdaten zu schützen und die Ratenlimits einzuhalten. Teste im Sandbox-Modus vor dem Produktivbetrieb. Siehe LICENSE, SECURITY.md und EBAY_COMPLIANCE.md.
- Funktionen
- eBay MCP im Vergleich zur reinen eBay-API
- KI-gestützte Einrichtung mit einem Klick
- Schnellstart
- Demo
- Konfiguration
- Verfügbare Tools
- Interaktive Oberfläche (MCP Apps) — Beta
- Anwendungsbeispiele
- Protokollierung und Fehlerbehebung
- FAQ
- Mitwirken
- Ressourcen
- Lizenz
- Mitwirkende
- 299 eBay-API-Tools — 100% Abdeckung der eBay-Sell-APIs für Bestand, Bestellungen, Marketing, Analytik, Metadaten, Taxonomie und Entwicklerwerkzeuge.
- 9 KI-Clients, automatisch konfiguriert — Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI und Amazon Q Developer.
- OAuth 2.0 integriert — vollständige Verwaltung von Benutzer-Tokens mit automatischer Erneuerung und intelligentem Rückfall von Benutzer-Tokens (10k–50k Anfragen/Tag) auf Client-Zugangsdaten (1k Anfragen/Tag).
- Standardmäßig robust — automatischer Wiederholungsversuch mit exponentiellem Backoff bei
429-Ratenlimits und konsistente, deutliche Fehlermeldungen. - Typsicher — durchgängig TypeScript, mit Zod validierte Tool-Eingaben und aus OpenAPI generierte Typen.
- Lokal und privat — läuft über STDIO oder lokales HTTP; deine Zugangsdaten und Daten verlassen niemals deinen Rechner.
- Sandbox und Produktion — wechsle die Umgebung mit einer einzigen Variablen.
- Einrichtung mit einem Befehl —
npm run setupkonfiguriert Zugangsdaten, OAuth und deinen MCP-Client und öffnet automatisch den Browser für den OAuth-Ablauf. - Gut getestet — über 1000 automatisierte Tests laufen bei jeder Änderung in der CI.
Beide sprechen mit denselben eBay-Endpunkten — der Unterschied ist alles, was du sonst selbst bauen müsstest.
| eBay MCP-Server | Reine eBay-REST-API | |
|---|---|---|
| Schnittstelle | Natürliche Sprache über deinen KI-Assistenten | Handgeschriebene HTTP-Anfragen und JSON-Parsing |
| OAuth & Token-Erneuerung | Integriert, mit automatischer Erneuerung | Du implementierst und pflegst sie |
| Umgang mit Ratenlimits | Automatischer Wiederholungsversuch mit exponentiellem Backoff | Manuelle 429-Behandlung und Backoff |
| Eingabevalidierung | Zod-Schemata + TypeScript-Typen für jedes Tool | Keine — du validierst deine eigenen Payloads |
| Einrichtung | Ein Assistent (npm run setup) |
Auth, Header und Marketplace pro Aufruf |
| Unterstützung von KI-Clients | 9 Clients automatisch konfiguriert | Nicht zutreffend |
| API-Abdeckung | 299 Tools über 100% der Sell-APIs, einsatzbereit | Du baust jede Anfrage anhand der Doku selbst |
| Hosting | Läuft lokal, kein Cloud-Relay | Deine eigene Infrastruktur |
Lass deinen KI-Assistenten das für dich einrichten. Kopiere den Prompt unten und füge ihn in Claude, ChatGPT oder einen beliebigen KI-Assistenten mit MCP-Unterstützung ein.
Klicke, um den KI-Einrichtungs-Prompt zu kopieren
I want to set up the eBay MCP Server for my AI assistant. Please help me:
1. Install the eBay MCP server:
npm install -g ebay-mcp
2. I need to configure it for [Claude Desktop / Cursor / Cline / Zed / Continue.dev / Windsurf / Claude Code CLI / Amazon Q] (choose one)
3. My eBay credentials are:
- Client ID: [YOUR_CLIENT_ID]
- Client Secret: [YOUR_CLIENT_SECRET]
- Environment: [sandbox / production]
- Redirect URI (RuName): [YOUR_REDIRECT_URI]
Please:
- Create the appropriate config file for my MCP client
- Set up the environment variables
- Help me complete the OAuth flow to get a refresh token for higher rate limits
- Test that the connection works
If I don't have eBay credentials yet, guide me through creating a developer account at https://developer.ebay.com/
- Erstelle ein kostenloses eBay-Entwicklerkonto.
- Generiere App-Schlüssel im Entwicklerportal.
- Speichere deine Client ID und dein Client Secret.
npm install -g ebay-mcp # von npm (empfohlen)Oder aus dem Quellcode:
git clone https://github.com/YosefHayim/ebay-mcp.git
cd ebay-mcp && npm install && npm run buildnpm run setupDer Assistent konfiguriert deine eBay-Zugangsdaten, richtet OAuth ein (für höhere Ratenlimits), erkennt und konfiguriert deinen MCP-Client automatisch und speichert alles automatisch.
Starte deinen MCP-Client (Claude Desktop usw.) neu und beginne, eBay über deinen KI-Assistenten zu verwalten.
📸 Visuelle Einrichtungsanleitung (eBay-Entwicklerportal)
Der Einrichtungsassistent (npm run setup) übernimmt OAuth automatisch. Hier findest du deine Zugangsdaten im eBay-Entwicklerportal:
Schritt 1 — Kopiere im Entwicklerportal deine App ID (Client ID) und deine Cert ID (Client Secret):
Schritt 2 — Kopiere in den User Tokens-Einstellungen deiner App den RuName (eBay-Weiterleitungs-URL):
Schritt 3 — Führe npm run setup aus. Es öffnet deinen Browser für die OAuth-Anmeldung und führt dich durch die eBay-Anmeldung:
Schritt 4 — Füge den Autorisierungscode aus der Callback-URL ein, wenn du dazu aufgefordert wirst:
Der Assistent tauscht den Code gegen Tokens, speichert sie und konfiguriert deinen MCP-Client. Du hast nun eine Authentifizierung mit Benutzer-Token (10k–50k Anfragen/Tag statt der standardmäßigen 1k/Tag).
Sieh dir den eBay MCP-Server in Aktion mit Claude Desktop an:
video-tutorial.mp4
📖 Die vollständige Referenz —jede Umgebungsvariable, jeder OAuth-Schritt und jeder Scope— steht im Konfigurationsleitfaden.
npm run setupschreibt die.envfür dich; die Variablen unten dienen nur als Referenz.
EBAY_CLIENT_ID=your_client_id
EBAY_CLIENT_SECRET=your_client_secret
EBAY_ENVIRONMENT=sandbox # oder "production"
EBAY_REDIRECT_URI=your_runame
EBAY_MARKETPLACE_ID=EBAY_US # Standard-Marketplace (pro Tool überschreibbar)
EBAY_CONTENT_LANGUAGE=en-US # Standard-Inhaltssprache der Anfragen
EBAY_USER_REFRESH_TOKEN=your_token # für höhere Ratenlimits
EBAY_MCP_UI=on # interaktive MCP-Apps-Ansichten (Beta); auf "off" setzen, um reines JSON zu erzwingen| Modus | Tageslimit | Am besten für | Einrichtung |
|---|---|---|---|
| Client-Zugangsdaten (Standard) | 1000 Anfragen/Tag | Entwicklung, Tests | Automatisch mit Client ID + Secret |
| Benutzer-Token (empfohlen) | 10k–50k Anfragen/Tag | Produktion, hohe Last | OAuth über npm run setup |
Die Limits des Benutzer-Tokens variieren je nach Kontostufe (Individual 10k · Commercial 25k · Enterprise 50k+). Bei einem 429 wiederholt der Server die Anfrage mit exponentiellem Backoff und meldet den Fehler. Details im Konfigurationsleitfaden und in der OAuth-Kurzreferenz; die Nutzung kannst du im Entwicklerportal überwachen.
Automatisch konfiguriert durch npm run setup. Erfordert Node.js ≥ 20 und das MCP-Protokoll 1.0+ über STDIO (Standard) oder HTTP.
| Client | Plattform | Konfigurationspfad |
|---|---|---|
| Claude Desktop | macOS, Windows, Linux | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor IDE | macOS, Windows, Linux | ~/.cursor/mcp.json |
| Zed Editor | macOS, Windows, Linux | ~/.config/zed/settings.json |
| Cline | VS-Code-Erweiterung | ~/...globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json |
| Continue.dev | VS Code, JetBrains | ~/.continue/config.json |
| Windsurf (Codeium) | macOS, Windows, Linux | ~/.codeium/windsurf/mcp_config.json |
| Roo Code | VS-Code-Erweiterung | ~/...globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json |
| Claude Code CLI | Terminal | ~/.claude.json |
| Amazon Q Developer | AWS | ~/.aws/amazonq/mcp.json |
299 Tools, 100% Sell-API-Abdeckung, nach Kategorie geordnet. Jeder Link verweist auf die Tool-Definitionen und ihre Handler in src/tools/categories/:
| Kategorie | Was du tun kannst |
|---|---|
| Connector | ChatGPT-Connector-Search/Fetch über den eBay-MCP-Katalog |
| Account | Geschäfts-, Versand-, Zahlungs- und Rückgaberichtlinien; Programme; Abonnements; Verkaufssteuer |
| Inventory | Bestandsartikel, Angebote, Standorte, Artikelgruppen, Massenvorgänge, SKU/Standort-Zuordnung |
| Fulfillment | Bestellungen, Versand, Rückerstattungen, Streitfälle, Nachweise zu Zahlungsstreitfällen |
| Marketing | Kampagnen für beworbene Angebote, Anzeigen, Aktionen, Gebote, Massenvorgänge |
| Analytics | Traffic-Berichte, Verkäuferstandards, Kundenservice-Kennzahlen |
| Communication | Käufer-Verkäufer-Nachrichten, Verhandlungen, Benachrichtigungen, Bewertungen |
| Metadata | Rückgaberichtlinien, Verkaufssteuer-Zuständigkeiten, Fahrzeugkompatibilität |
| Taxonomy | Kategoriebäume, Artikelmerkmale, Artikelzustände |
| Browse | Suche nach verkauften/abgeschlossenen Angeboten (Finding API) für Preisvergleiche |
| Other | Identity, VeRO, Übersetzung und internationale Versand-Support-APIs (Compliance-Tools melden eBays Stilllegung vom 2026-03-30) |
| Trading (Legacy-XML) | Festpreisangebote erstellen, überarbeiten, neu einstellen und beenden |
| Developer | Ratenlimits, Signaturschlüssel, Client-Registrierung |
| Token Management | OAuth-URL-Generierung und Token-Verwaltung |
Beispiel-Tools: ebay_get_inventory_items, ebay_get_orders, ebay_create_offer, ebay_get_campaigns, ebay_get_oauth_url.
Den vollständigen maschinenlesbaren Index findest du in llms.txt.
Beta — diese Funktion ist neu und entwickelt sich gemeinsam mit der MCP-Apps-Spezifikation weiter, und die Host-Unterstützung wird gerade erst ausgerollt. Sie ist Opt-in und greift auf reines JSON zurück, sodass bestehende Clients niemals kaputtgehen. Schalte sie mit
EBAY_MCP_UIum.
Auf Hosts, die MCP Apps unterstützen, stellen gängige Lese-Tools ihre Ergebnisse als interaktive Ansichten statt als reines JSON dar — eine sortierbare Tabelle, eine Detail-Karte oder ein Diagramm — und nutzen dabei das eigene Theme des Hosts. Überall sonst liefern dieselben Tools weiterhin reines JSON, sodass nichts kaputtgeht. Sie basiert auf dem MCP Apps SDK (@modelcontextprotocol/ext-apps), der Erweiterung, mit der MCP-Server interaktive Oberflächen an dialogorientierte Clients ausliefern können.
- Opt-in und Host-gesteuert. Ansichten werden nur Clients angeboten, die die MCP-Apps-Fähigkeit ankündigen (z. B. Claude). Hosts ohne sie (z. B. Cursor) erhalten stillschweigend JSON.
- Notausschalter. Setze
EBAY_MCP_UI=off, um überall reines JSON zu erzwingen, selbst auf fähigen Hosts. - Token-sparsam. Das HTML jeder Ansicht wird vom Host einmalig außerhalb des Kontexts abgerufen (niemals in den Kontext des Modells); das Modell sieht nur eine einzeilige Zusammenfassung sowie die strukturierten Daten, die es ohnehin erhalten hätte.
- Schreibgeschützt. Ansichten lösen ausschließlich Lese-Tools aus (in eine Zeile eintauchen, blättern, aktualisieren) — sie verändern deine eBay-Daten niemals.
13 Tools für zentrale Arbeitsabläufe nehmen heute teil, über drei Archetypen hinweg:
| Archetyp | Tools |
|---|---|
| Tabelle | ebay_get_orders, ebay_get_shipping_fulfillments, ebay_get_offers, ebay_get_inventory_items, ebay_get_inventory_locations, ebay_get_payment_dispute_summaries |
| Karte | ebay_get_order, ebay_get_offer, ebay_get_inventory_item, ebay_get_payment_dispute, ebay_get_seller_standards_profile |
| Diagramm | ebay_get_traffic_report, ebay_get_customer_service_metric |
Die Ansichten werden mit npm run build (oder npm run build:ui) zu eigenständigem HTML gebaut; sie sind im veröffentlichten Paket enthalten und laden ohne eigenen Netzwerkzugriff.
Häufige Aufgaben, formuliert wie du sie deinem KI-Assistenten stellen würdest:
- OAuth einrichten — „Hilf mir, OAuth für mein eBay-Konto einzurichten.“ → generiert eine Autorisierungs-URL über
ebay_get_oauth_urlund konfiguriert dann das Refresh-Token. Schaltet 10k–50k Anfragen/Tag frei. - Bestand verwalten — „Zeig mir alle meine aktiven Angebote.“ →
ebay_get_inventory_itemsliefert SKUs, Mengen und Status. - Bestellungen bearbeiten — „Hol alle unerledigten Bestellungen der letzten 7 Tage.“ →
ebay_get_ordersmit Datums- und Versandstatus-Filtern. - Kampagnen erstellen — „Erstelle eine Kampagne für beworbene Angebote für Elektronik.“ →
ebay_create_campaignund zugehörige Marketing-Tools. - Massenvorgänge — „Gewähre 10% Rabatt auf alle Artikel der Kategorie 'Vintage-Uhren'.“ →
ebay_get_inventory_items+ebay_update_offerüber die Treffer.
- Protokollierung — auf Winston basierend, nach stderr geschrieben (MCP-sicher), mit optionaler Dateiausgabe. Siehe docs/logging.md.
- Fehlerbehebung — Server erscheint nicht, Authentifizierungsfehler, Ratenlimits, leere Ergebnisse. Beginne mit
npm run diagnoseund siehe dann docs/troubleshooting.md.
Ein lokaler Model-Context-Protocol-Server, der 299 Tools bereitstellt, die 100% der Sell-APIs von eBay (270 Endpunkte) für KI-Assistenten abdecken — Bestand, Auftragsabwicklung, Marketing, Analytik und Entwicklertools.
Nein. Es ist ein inoffizielles Open-Source-Projekt eines Drittanbieters. Es ist nicht mit eBay Inc. verbunden, von eBay autorisiert oder gebilligt.
npm run setup konfiguriert neun Clients automatisch: Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI und Amazon Q Developer. Jeder MCP-kompatible Client kann sich verbinden.
Ja. Es funktioniert von Haus aus mit Claude Desktop und Claude Code, mit Cursor und anderen MCP-fähigen IDEs sowie mit jedem Assistenten, der das Model Context Protocol unterstützt. Der Ein-Klick-Einrichtungs-Prompt oben funktioniert auch mit ChatGPT und anderen Assistenten.
Interaktive Ansichten via MCP Apps erscheinen nur auf Hosts, die die Fähigkeit ankündigen (z. B. Claude); andere Clients erhalten dieselben Daten als reines JSON. Stelle außerdem sicher, dass du EBAY_MCP_UI=off nicht gesetzt hast und dass die Ansichten gebaut sind (npm run build führt build:ui aus).
299 Tools über 270 eindeutige Endpunkte — 100% der Sell-APIs von eBay.
Ja. Es wird unter der MIT-Lizenz veröffentlicht.
Es läuft vollständig auf deinem Rechner über STDIO (oder lokales HTTP). Es gibt kein Cloud-Relay — deine eBay-Zugangsdaten verlassen niemals deinen Computer.
Node.js ≥ 20, ein kostenloses eBay-Entwicklerkonto (Client ID + Client Secret) und dann npm run setup.
Client-Zugangsdaten (Standard) erlauben etwa 1000 Anfragen/Tag. Die Authentifizierung mit einem Benutzer-Token über OAuth hebt dies je nach Kontostufe auf 10.000–50.000 Anfragen/Tag an.
Ja. Wechsle mit der Variablen EBAY_ENVIRONMENT (sandbox oder production).
Zugangsdaten werden lokal in deiner .env-Datei gespeichert und nur verwendet, um eBay direkt aufzurufen. Siehe SECURITY.md und EBAY_COMPLIANCE.md.
Du interagierst in natürlicher Sprache über deinen KI-Assistenten. OAuth-Token-Verwaltung, automatische Wiederholungen mit Backoff und typsichere Zod-Validierung sind integriert. Siehe die Vergleichstabelle oben.
Ja. Das Erstellen, Überarbeiten, Neueinstellen und Beenden von Festpreisangeboten wird über die Trading-API-Tools unterstützt.
Schließe den OAuth-Ablauf mit npm run setup ab, um dich mit einem Benutzer-Token zu authentifizieren (10k–50k Anfragen/Tag statt der standardmäßigen 1k).
TypeScript und Node.js (ESM), mit dem offiziellen MCP-SDK, Zod zur Validierung und aus OpenAPI generierten Typen.
Führe npm install -g ebay-mcp@latest (oder npm update -g ebay-mcp) aus.
Nein. „Läuft lokal“ bedeutet, dass der Serverprozess auf deinem Rechner läuft — er benötigt dennoch eine Internetverbindung und gültige Zugangsdaten, um die Live-APIs von eBay zu erreichen.
Beiträge sind willkommen. Forken → Branch erstellen → Tests hinzufügen → npm run check && npm test → mit Conventional Commits committen → PR öffnen.
- Arbeitest du am Code oder mit einem Programmieragenten? Beginne mit AGENTS.md — Build-/Test-Befehle, Modulübersicht und der Ablauf zum Hinzufügen eines Endpunkts.
- Vollständiger Leitfaden: CONTRIBUTING.md.
- eBay-Entwicklerportal — API-Dokumentation und Zugangsdaten
- eBay-API-Lizenzvereinbarung — Bedingungen und Compliance
- eBay-Anforderungen an die Datenverarbeitung — Datenschutz und Privatsphäre
- MCP-Dokumentation — Spezifikation des Model Context Protocol
- OAuth-Kurzreferenz — Scopes, Fehlerbehebung, Beispiele
- eBay-API-Status — offizielle Statusseite (auch über das Tool
ebay_get_api_statusund den Snapshot im Repository) - CHANGELOG.md · SECURITY.md · CODE_OF_CONDUCT.md
- Issue-Tracker — Fehlerberichte und Funktionswünsche
MIT — siehe LICENSE.
Danke an alle, die geholfen haben, dieses Projekt zu verbessern! 🎉
Dieses Projekt unterstützen · Erstellt von Yosef Hayim Sabag
eBay MCP-Server · Model Context Protocol für die eBay-Sell-APIs · verbinde Claude, Cursor und jeden KI-Assistenten mit eBay-Bestand, -Bestellungen, -Marketing und -Analytik.