shopping-mcp

Ein MCP-Server, der es Claude (oder einem beliebigen MCP-Client) ermöglicht, eBay-Angebote über die offizielle Browse API zu durchsuchen.

Fragen Sie „Finde mir eine mechanische Tastatur unter 100 $, nur Sofort-Kaufen, kostenloser Versand" und der Assistent kann tatsächlich losgehen und nachsehen.

eBay results for "mechanical keyboard" — showing 3 of about 41,208 matches

1. Keychron K8 Pro Wireless Mechanical Keyboard - Brown Switches — $79.99
   total $79.99 · free shipping · New · was $99.00 (19% off)
   seller keeb_supply · 99.6% positive (8421 ratings) · top rated, ships from US
   Item v1|335894120043|0 · https://www.ebay.com/itm/335894120043

2. Ducky One 3 TKL Mechanical Keyboard RGB Hot-Swappable — $84.50
   total $92.45 · $7.95 shipping · New
   seller pc_parts_direct · 98.9% positive (3310 ratings) · accepts offers
   Item v1|326770118254|0 · https://www.ebay.com/itm/326770118254

Was es tut – und was es bewusst nicht tut

Jedes Tool ist schreibgeschützt. Dieser Server durchsucht und liest Angebote. Er kann nicht mitbieten, in den Warenkorb legen, eine Bestellung aufgeben oder Geld ausgeben. Wenn Sie kaufen möchten, gibt er Ihnen einen Angebotslink und Sie wickeln den Kauf selbst ab.

Er basiert auf der offiziellen eBay Browse API – kein Scraping, keine Browser-Automatisierung, kein Cookie-Replay. Er bricht nicht bei einer Layout-Änderung und bringt Sie nicht in Konflikt mit den eBay-Nutzungsbedingungen.

Related MCP server: ebay-mcp

Tools

Zwei Dinge, die Sie über search_ebay wissen sollten, denn das ist es, was eBay hat und ein Festpreis-Katalog nicht:

• buying_option filtert nach auction, buy_it_now oder accepts_offers.

• sort: "ending_soonest" – kombiniert mit buying_option: "auction" finden Sie so Auktionen, die kurz vor dem Ende stehen.

API-Schlüssel erhalten

1. Melden Sie sich unter developer.ebay.com/my/keys an.

2. Erstellen Sie eine Anwendung und öffnen Sie den Production-Schlüsselsatz.

3. Kopieren Sie die App ID (Client ID) und die Cert ID (Client Secret).

Das ist alles. Dieser Server verwendet den OAuth-Client-Credentials-Ablauf, Sie benötigen also kein Benutzertoken, keine Redirect-URI und keinen „RuName".

Neue Entwicklerkonten müssen möglicherweise die eBay-Verifizierung durchlaufen, bevor die Schlüsselseite freigeschaltet wird – das dauert in der Regel etwa einen Werktag.

Installation

git clone https://github.com/Kirat5690/shopping-mcp.git

cd shopping-mcp && npm install && npm run build

Mit einem Client verbinden

Claude Code

claude mcp add shopping --env EBAY_CLIENT_ID=your-app-id --env EBAY_CLIENT_SECRET=your-cert-id -- node /absolute/path/to/shopping-mcp/dist/index.js

Claude Desktop

Bearbeiten Sie claude_desktop_config.json:

• macOS – ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows – %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "shopping": {
      "command": "node",
      "args": ["C:\\path\\to\\shopping-mcp\\dist\\index.js"],
      "env": {
        "EBAY_CLIENT_ID": "your-app-id",
        "EBAY_CLIENT_SECRET": "your-cert-id",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

Starten Sie den Client neu und bitten Sie ihn dann, check_ebay_connection auszuführen, um zu bestätigen, dass die Anmeldedaten funktionieren.

Konfigurationsreferenz

Anmerkungen zu den Zahlen

• Der Endpreis (inkl. Versand) bestimmt das Ranking. Die Sortierung nach Preis verwendet den Artikelpreis plus Versand, sodass ein günstiger Artikel mit teurem Versand nicht durch eine technische Formalität gewinnt. Die eigene Preissortierung von eBay macht das nicht immer.

• Manche Angebote haben keinen Gesamtpreis. Wo eBay die Versandkosten erst beim Checkout berechnet, gibt es keinen Endpreis, bis eine Lieferadresse bekannt ist – und das Angebot sagt dies, anstatt zu raten.

• Keine Währungsumrechnung. Preise werden in der Währung des Marktplatzes angezeigt, genau wie eBay sie zurückgibt.

• Angebote sind einzelne Verkäufe, keine Katalogeinträge. Zwei Ergebnisse mit nahezu identischen Titeln können sich in Zustand, Bundle-Inhalt oder Region unterscheiden. Es lohnt sich, dies zu prüfen, bevor man sie als denselben Artikel behandelt.

• find_deals sieht nur beworbene Rabatte. Es filtert nach dem durchgestrichenen „Vorher"-Preis von eBay, sodass ein wirklich günstiges Angebot, das nie einen Rabatt beansprucht hat, nicht erscheint.

Entwicklung

npm test

Die Testsuite läuft ohne eBay-Anmeldedaten. Sie deckt die Geld- und Endpreis-Logik, die Ausgabeformatierung und einen End-to-End-MCP-Protokolltest ab, der den Server über stdio startet und die Tool-Registrierung, Schemavalidierung und die Pfade ohne konfigurierte Anmeldedaten testet.

npm run watch      # recompile on change
npm run typecheck  # types only, no emit

Layout:

src/
  index.ts     server entry point and stdio wiring
  tools.ts     MCP tool definitions
  ebay.ts      Browse API client and OAuth token cache
  config.ts    environment parsing and marketplace table
  money.ts     price parsing, landed totals, ranking
  format.ts    human-readable output
  http.ts      fetch with timeout and retry

Eine Anmerkung zum Umfang

Frühere Versionen unterstützten auch Amazon über die Product Advertising API. Diese wurde in v0.2.0 entfernt: Die PA-API erfordert ein genehmigtes Amazon-Associates-Konto, und Amazon entzieht den Zugriff, wenn das Konto keine qualifizierenden Verkäufe erzielt – eine zu hohe Hürde für die meisten, um den Server überhaupt zum Laufen zu bringen.

Der Amazon-Client und seine AWS-SigV4-Signierung sind in der Git-Historie unter dem Tag v0.1.0-amazon erhalten, falls Sie ein genehmigtes Konto haben und sie zurückhaben möchten.

Lizenz

MIT – siehe LICENSE.

Nicht mit eBay verbunden, von eBay unterstützt oder gesponsert. Ihre Nutzung der eBay-API unterliegt der eBay-API-Lizenzvereinbarung.