Vinted-Sourcing automatisieren mit der API, MCP und den Webhooks von Vinotify

Wenn du Vinted-Artikel zum Weiterverkauf einkaufst, ist die nützliche Automatisierung meist unkompliziert: Behalte deine gespeicherten Suchen in Vinotify, lies neue Treffer in deinen eigenen Workflow ein und entscheide selbst, was du dir ansiehst oder kaufst. Vinotify liefert den verwalteten Such-Feed; dein Bot oder Coding-Agent kann den Rest der Übergabe übernehmen.

Die Integrationen stehen Pro-Konten zur Verfügung. Dazu gehören kontobezogene Bearer-Tokens, ein REST-Event-Feed, ein direkter MCP-Endpunkt für kompatible Agenten, ausgehende Webhooks und ein dauerhafter Event-Feed. Beginne mit der vollständigen Entwicklerdokumentation, sobald du einen Client anbinden möchtest.

Was brauchst du?

Es gibt drei Wege hinein, und sie passen zu unterschiedlichen Aufgaben. Wähle die Zeile, die zu dem passt, was du baust; jede verlinkt auf den Leitfaden, der das Thema ausführlich behandelt.

Ein Reseller-Workflow, der verständlich bleibt

1. Erstelle gespeicherte Suchen für die Artikel, Marken, Größen, Preise und Stichwörter, die du tatsächlich einkaufst.
2. Erstelle unter Integrationen ein schreibgeschütztes Integrations-Token und bewahre es in deiner lokalen Umgebung oder deinem Secret Store auf.
3. Ermittle die aktiven Suchen und lies dann jeden Event-Stream ab einem gespeicherten Cursor.
4. Dedupliziere über event_id, mache aus einem Treffer deinen eigenen Bestands- oder Prüfeintrag und öffne die Vinted-URL, wenn du ihn dir genauer ansehen willst.

Events werden mindestens einmal zugestellt. Das ist für einen robusten Bot nützlich, bedeutet aber, dass dein Consumer next_cursor speichern und eine wiederholte event_id, die er schon verarbeitet hat, ignorieren sollte.

REST für einen kleinen Poller oder Bot

Ein Coding-Agent kann einen kleinen Worker um zwei Aufrufe herum bauen: aktive Suchen mit /api/v1/integrations/discovery/v2 aktualisieren und dann /api/v1/integrations/events?search_id=…&cursor=…&wait=30 per Long Poll abfragen. Die Antwort enthält die Events und den nächsten Cursor für diese Suche.

Authorization: Bearer $VINOTIFY_TOKEN

GET https://vinotify.me/api/v1/integrations/discovery/v2
GET https://vinotify.me/api/v1/integrations/events?search_id=42&cursor=0-0&wait=30

Führe den Cursor pro Suche. Meldet der Feed, dass der Cursor abgelaufen ist, setze auf den zurückgegebenen Wert reset_cursor zurück. Gibt die API 429 zurück, warte die Zeit aus Retry-After ab; bei 503 warte länger, ohne den gespeicherten Cursor zu verwerfen.

MCP für einen Coding-Agenten, kurz gefasst

MCP passt gut, wenn ein Agent deine Alarme in normaler Sprache prüfen soll. Richte einen kompatiblen Client auf https://vinotify.me/api/v1/mcp aus und trage das Bearer-Token in der lokalen Konfiguration dieses Clients ein. Die Lese-Tools sind list_searches, get_new_items und whats_new.

Schreib-Tools sind getrennt und eng gefasst. Ein Token muss mit Schreibzugriff erstellt werden, und die Schreibfunktion muss auch auf dem Server aktiviert sein, bevor ein Agent eine Suche erstellen, aktualisieren, pausieren, fortsetzen oder löschen kann. Lass das Token schreibgeschützt, solange du keinen klaren Grund hast, Änderungen an Suchen zu delegieren.

{
  "mcpServers": {
    "vinotify": {
      "url": "https://vinotify.me/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Client-Konfiguration, die vollständige Tool-Liste und das Token-Modell findest du in den Vinotify-MCP-Server mit KI-Tools verbinden.

Push oder Pull, kurz gefasst

Push ist der schnellste Weg. Lege mit PUT /api/v1/searches/<search_id>/webhook/external-url ein Ziel für eine Pro-Suche fest, und Vinotify sendet per POST einen new_items-Body dorthin, sobald eine Suche etwas findet. Das Ziel muss ein öffentlicher HTTPS-Endpunkt sein, und Vinotify prüft es sowohl beim Speichern als auch vor jeder Zustellung erneut.

Push arbeitet allerdings nach dem Best-Effort-Prinzip. Es gibt keine Warteschlange für Wiederholungen: Ist dein Empfänger nicht erreichbar, ist die Zustellung verloren. Die Nutzdaten bleiben 24 Stunden lang unter /api/v1/searches/<search_id>/webhook/latest abrufbar, und der per Bearer-Token authentifizierte Event-Feed unter /api/v1/integrations hält 48 Stunden Verlauf hinter einem Cursor bereit. Betreibe den Feed neben Push, wenn du dir keinen verpassten Artikel leisten kannst, und dedupliziere über event_id.

Aufbau der Nutzdaten, Wiederholungsverhalten und konkrete Setups findest du in dem Leitfaden zur Webhook-Automatisierung.

Die Grenze klar halten

Vinotify liefert Belege zum Angebot, etwa den Erfassungszeitpunkt, Angebotspreis und Währung, Titel, URL, Artikel-ID und verfügbare Artikeldetails. Es kauft keine Artikel, verlangt keine Vinted-Zugangsdaten und macht aus einem Alarm keinen bestätigten Verkauf. Dein eigener Workflow kann Kandidaten bewerten oder in eine Warteschlange stellen, aber halte diese Entscheidungen getrennt von dem, was das Event tatsächlich belegt.

Bewahre das Token außerhalb der Versionsverwaltung auf, aktualisiere die Discovery, wenn sich deine Suchen ändern, und widerrufe das Token unter Integrationen, sobald du es nicht mehr brauchst. Genaue Parameter, Limits, Antwortfelder und Fehler findest du in der Vinotify-Entwicklerdokumentation.