Secondhand MCP

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten die Suche auf Secondhand-Marktplätzen ermöglicht. Durchsuchen Sie Facebook Marketplace, eBay, Depop und Poshmark nach gebrauchten Artikeln – filtern Sie nach Preis, Kategorie, Zustand, Größe und Farbe und erhalten Sie vollständige Angebotsdetails mit Fotos, Beschreibungen und Verkäuferinformationen.

Funktioniert mit Claude Desktop, Claude Code, Cursor und jedem MCP-kompatiblen Client.

[!TIPP] Möchten Sie die Einrichtung überspringen? Probieren Sie Secondhand MCP Cloud – die gehostete Version, die in 30 Sekunden eine Verbindung zu Claude.ai und ChatGPT herstellt. Keine Installation oder Chrome erforderlich. Kostenloses Kontingent inklusive.

Unterstützte Marktplätze

Related MCP server: BopMarket MCP Server

Einrichtung

Claude Desktop

Fügen Sie zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "secondhand": {
      "command": "npx",
      "args": ["-y", "secondhand-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your-ebay-client-id",
        "EBAY_CLIENT_SECRET": "your-ebay-client-secret",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

Claude Code

Fügen Sie zu ~/.claude/.mcp.json hinzu:

{
  "mcpServers": {
    "secondhand": {
      "command": "npx",
      "args": ["-y", "secondhand-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your-ebay-client-id",
        "EBAY_CLIENT_SECRET": "your-ebay-client-secret",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

eBay, Depop und Poshmark sind alle optional – wenn eBay-API-Schlüssel fehlen oder Chrome nicht installiert ist, werden diese Marktplätze automatisch deaktiviert und der Rest funktioniert weiterhin.

Depop & Poshmark / Chrome-Anforderung

Depop und Poshmark benötigen einen Headless-Browser. Wenn Google Chrome oder Chromium auf Ihrem System installiert ist, werden beide automatisch aktiviert – keine Konfiguration erforderlich. Wenn Chrome nicht gefunden wird, werden sie stillschweigend übersprungen.

Auf macOS kann beim ersten Durchsuchen von Depop oder Poshmark eine Systemaufforderung erscheinen, die fragt, ob Node.js Chrome steuern darf. Dies ist zu erwarten – Puppeteer muss Chrome im Headless-Modus starten. Erlauben Sie es einmal, und es wird nicht erneut gefragt.

Der Browser läuft unsichtbar im Hintergrund und startet nur, wenn Sie tatsächlich Depop oder Poshmark durchsuchen.

Konfiguration

Marktplätze auswählen

Standardmäßig sind alle Marktplätze aktiviert. Um einzuschränken, welche aktiv sind, setzen Sie die Umgebungsvariable MARKETPLACES (kommagetrennt):

{
  "env": {
    "MARKETPLACES": "facebook,ebay"
  }
}

Gültige Werte: facebook, ebay, depop, poshmark

eBay-API-Schlüssel

eBay verwendet die offizielle Browse-API. Sie benötigen ein kostenloses eBay-Entwicklerkonto:

1. Erstellen Sie ein Konto auf developer.ebay.com

2. Erstellen Sie eine Anwendung, um eine Client-ID und ein Client-Geheimnis zu erhalten

3. Fügen Sie diese Ihrer MCP-Konfiguration als EBAY_CLIENT_ID und EBAY_CLIENT_SECRET hinzu

eBay-Marktplatz / Region

Standardmäßig zielt der Server auf die US-eBay-Seite ab. Um einen anderen regionalen Marktplatz zu durchsuchen, setzen Sie die Umgebungsvariable EBAY_MARKETPLACE_ID:

{
  "env": {
    "EBAY_MARKETPLACE_ID": "EBAY_DE"
  }
}

Häufige Werte:

Die vollständige Liste finden Sie in der eBay-API-Dokumentation.

Werkzeuge

search_marketplace

Durchsuchen Sie Artikel auf allen Marktplätzen.

Pro Marktplatz zurückgegebene Daten:

get_listing_details

Rufen Sie vollständige Details zu einem bestimmten Angebot mithilfe einer ID aus den Suchergebnissen ab.

Pro Marktplatz zurückgegebene Daten:

list_marketplaces

Listet alle aktivierten Marktplätze und deren Status auf.

search / fetch (Tiefenrecherche)

Bequemes Paar gemäß dem ChatGPT Deep Research Tool Contract – exakte Namen, jeweils ein einzelnes Zeichenkettenargument:

• search(query) – durchsucht alle aktivierten Marktplätze gleichzeitig und gibt { results: [{ id, title, text, url }] } zurück, wobei id marketplace:listingId ist

• fetch(id) – gibt vollständige Angebotsdetails für eine search-Ergebnis-ID als { id, title, text, url, metadata } zurück

Nützlich für forschungsorientierte Clients, die diese standardmäßigen Werkzeugnamen erwarten; für gefilterte Suchen verwenden Sie search_marketplace.

Funktionsweise

Facebook Marketplace – Durchsucht Angebote nach Standort, Preis und Suchbegriff. Löst Stadtnamen in Koordinaten auf. Kein Login oder Browser erforderlich.

eBay – Verwendet die offizielle eBay Browse-API mit OAuth 2.0-Client-Anmeldeinformationen. Token werden zwischengespeichert und automatisch erneuert. Der Zielmarktplatz wird durch EBAY_MARKETPLACE_ID gesteuert (Standard: EBAY_US).

Depop – Verwendet einen Headless-Browser, um Angebote mit Unterstützung für Kategorie-, Zustands-, Größen- und Farbfilter zu durchsuchen. Die Browser-Instanz wird über mehrere Anfragen hinweg gemeinsam genutzt.

Poshmark – Verwendet einen Headless-Browser, um Angebote mit Unterstützung für Zustands-, Größen-, Farb-, Sortier- und Preisfilter zu durchsuchen. Poshmark ist nicht standortbasiert – alle Artikel werden national versendet.

Entwicklung

git clone https://github.com/jlsookiki/secondhand-mcp.git
cd secondhand-mcp
npm install
npm run build

Hinzufügen eines Marktplatzes

1. Erstellen Sie eine neue Datei in src/marketplaces/

2. Erweitern Sie BaseMarketplace und implementieren Sie search() und optional getListingDetails()

3. Fügen Sie den Konstruktor zu allMarketplaces in src/marketplaces/index.ts hinzu

Einschränkungen

• Facebook: Kann brechen, wenn Facebook sein Frontend ändert

• eBay: Erfordert Entwickler-API-Schlüssel (kostenloses Kontingent verfügbar)

• Depop: Erfordert installiertes Chrome/Chromium; langsamer als Facebook/eBay (~5 s pro Suche)

• Poshmark: Erfordert installiertes Chrome/Chromium; keine offizielle API, daher basiert es auf Seiten-Scraping

• Ratenbegrenzung: Machen Sie nicht zu viele Anfragen zu schnell

Lizenz

MIT