Automatizza il sourcing su Vinted con l’API, l’MCP e i webhook di Vinotify

Se cerchi articoli su Vinted da rivendere, l’automazione utile di solito è semplice: tieni le tue ricerche in Vinotify, porta le nuove corrispondenze nel tuo flusso di lavoro e decidi tu cosa controllare o acquistare. Vinotify fornisce il feed di ricerca gestito; il tuo bot o il tuo agente di coding può occuparsi del resto del passaggio di consegne.

Le integrazioni sono disponibili per gli account Pro. Comprendono token bearer legati all’account, un feed di eventi REST, un endpoint MCP diretto per gli agenti compatibili, webhook in uscita e un feed di eventi durevole. Parti dalla documentazione per sviluppatori completa quando sei pronto a collegare un client.

Quale ti serve?

Ci sono tre modi per entrare, adatti a compiti diversi. Scegli la riga che corrisponde a ciò che stai costruendo; ognuna rimanda alla guida che la tratta come si deve.

Un flusso di lavoro da rivenditore che resta comprensibile

1. Crea ricerche per gli articoli, le marche, le taglie, i prezzi e le parole chiave che cerchi davvero.
2. Crea un token di integrazione di sola lettura in Integrazioni e conservalo nel tuo ambiente locale o nel tuo secret store.
3. Individua le ricerche attive, poi leggi ogni flusso di eventi a partire da un cursore salvato.
4. Deduplica con event_id, trasforma una corrispondenza in un tuo record di inventario o di verifica e apri l’URL di Vinted quando vuoi controllarla.

La consegna degli eventi avviene almeno una volta. È utile per un bot resiliente, ma significa che il tuo consumer deve salvare next_cursor e ignorare un event_id ripetuto che ha già gestito.

REST per un piccolo poller o bot

Un agente di coding può costruire un piccolo worker attorno a due chiamate: aggiornare le ricerche attive con /api/v1/integrations/discovery/v2, poi fare il long poll di /api/v1/integrations/events?search_id=…&cursor=…&wait=30. La risposta contiene gli eventi e il cursore successivo per quella ricerca.

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

Tieni un cursore per ogni ricerca. Se il feed segnala che il cursore è scaduto, riparti dal valore reset_cursor restituito. Se l’API restituisce 429, attendi il tempo indicato da Retry-After; se restituisce 503, rallenta senza scartare il cursore salvato.

MCP per un agente di coding, in breve

L’MCP è una buona scelta quando vuoi che un agente consulti i tuoi avvisi in linguaggio naturale. Punta un client compatibile su https://vinotify.me/api/v1/mcp e aggiungi il token bearer nella configurazione locale di quel client. Gli strumenti di lettura sono list_searches, get_new_items e whats_new.

Gli strumenti di scrittura sono separati e circoscritti. Un token può essere creato con accesso in scrittura, e anche la funzione di scrittura del server deve essere attiva, prima che un agente possa creare, aggiornare, mettere in pausa, riprendere o eliminare una ricerca. Lascia il token di sola lettura, a meno che tu non abbia un motivo chiaro per delegare le modifiche alle ricerche.

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

La configurazione dei client, l’elenco completo degli strumenti e il modello dei token sono trattati in collegare il server MCP di Vinotify agli strumenti di IA.

Push o pull, in breve

Il push è la via più veloce. Imposta una destinazione su una ricerca Pro con PUT /api/v1/searches/<search_id>/webhook/external-url e Vinotify invia un POST con un corpo new_items nel momento in cui una ricerca trova qualcosa. La destinazione deve essere un endpoint HTTPS pubblico, e Vinotify lo verifica sia quando lo salvi sia di nuovo prima di ogni consegna.

Il push però è di tipo «best effort». Non c’è una coda di nuovi tentativi, quindi se il tuo ricevitore è fuori servizio la consegna è persa. Il payload resta disponibile per 24 ore su /api/v1/searches/<search_id>/webhook/latest, e il feed di eventi autenticato con bearer sotto /api/v1/integrations conserva 48 ore di storico dietro un cursore. Se non puoi permetterti di perdere un articolo, fai girare il feed insieme al push e deduplica con event_id.

La struttura del payload, il comportamento dei nuovi tentativi e alcune configurazioni pratiche sono trattati in la guida all’automazione con i webhook.

Mantieni chiaro il confine

Vinotify fornisce prove sull’annuncio, come l’ora di rilevamento, il prezzo richiesto e la valuta, il titolo, l’URL, l’ID dell’articolo e i dettagli disponibili. Non acquista articoli, non richiede credenziali di Vinted e non trasforma un avviso in una vendita confermata. Il tuo flusso di lavoro può assegnare un punteggio ai candidati o metterli in coda, ma tieni queste decisioni separate da ciò che l’evento dimostra davvero.

Conserva il token fuori dal controllo di versione, aggiorna la discovery quando le tue ricerche cambiano e revoca il token da Integrazioni quando non ti serve più. Per parametri esatti, limiti, campi di risposta ed errori, usa la documentazione per sviluppatori di Vinotify.