Automatiser votre sourcing Vinted avec l’API, le MCP et les webhooks de Vinotify

Si vous sourcez des articles Vinted pour les revendre, l’automatisation utile est généralement simple : gardez vos recherches dans Vinotify, importez les nouvelles correspondances dans votre propre workflow, et décidez vous-même quoi examiner ou acheter. Vinotify fournit le flux de recherche géré ; votre bot ou votre agent de code peut s’occuper du reste de la chaîne.

L’ensemble des intégrations est réservé aux comptes Pro. Il comprend des tokens bearer liés au compte, un flux d’événements REST, un point d’accès MCP direct pour les agents compatibles, des webhooks sortants et un flux d’événements durable. Commencez par la documentation développeur complète lorsque vous serez prêt à connecter un client.

Laquelle vous faut-il ?

Il existe trois points d’entrée, adaptés à des usages différents. Choisissez la ligne qui correspond à ce que vous construisez ; chacune renvoie vers le guide qui la couvre en détail.

Un workflow de revendeur qui reste lisible

1. Créez des recherches pour les articles, marques, tailles, prix et mots-clés que vous sourcez réellement.
2. Créez un token d’intégration en lecture seule dans Intégrations et gardez-le dans votre environnement local ou votre gestionnaire de secrets.
3. Repérez les recherches actives, puis lisez chaque flux d’événements à partir d’un curseur enregistré.
4. Dédoublonnez avec event_id, transformez une correspondance en fiche de stock ou de contrôle qui vous est propre, et ouvrez l’URL Vinted quand vous voulez l’examiner.

La livraison des événements est « au moins une fois ». C’est utile pour un bot robuste, mais cela signifie que votre consommateur doit enregistrer next_cursor et ignorer tout event_id répété qu’il a déjà traité.

REST pour un petit poller ou un bot

Un agent de code peut construire un petit worker autour de deux appels : actualiser les recherches actives avec /api/v1/integrations/discovery/v2, puis faire un long poll sur /api/v1/integrations/events?search_id=…&cursor=…&wait=30. La réponse contient les événements et le curseur suivant pour cette recherche.

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

Conservez un curseur par recherche. Si le flux indique que le curseur a expiré, repartez de la valeur reset_cursor renvoyée. Si l’API renvoie 429, attendez le délai de Retry-After ; si elle renvoie 503, patientez avant de réessayer, sans jeter le curseur enregistré.

MCP pour un agent de code, en bref

Le MCP convient bien quand vous voulez qu’un agent consulte vos alertes en langage naturel. Pointez un client compatible vers https://vinotify.me/api/v1/mcp et ajoutez le token bearer dans la configuration locale de ce client. Les outils de lecture sont list_searches, get_new_items et whats_new.

Les outils d’écriture sont distincts et limités. Un token doit être créé avec un accès en écriture, et la fonction d’écriture doit aussi être activée côté serveur, avant qu’un agent puisse créer, modifier, mettre en pause, reprendre ou supprimer une recherche. Laissez le token en lecture seule, sauf si vous avez une bonne raison de déléguer les modifications de recherches.

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

La configuration des clients, la liste complète des outils et le modèle de tokens sont présentés dans connecter le serveur MCP de Vinotify à des outils d’IA.

Push ou pull, en bref

Le push est la voie la plus rapide. Définissez une destination sur une recherche Pro avec PUT /api/v1/searches/<search_id>/webhook/external-url et Vinotify envoie un POST contenant un corps new_items dès qu’une recherche trouve quelque chose. La destination doit être un point d’accès HTTPS public, et Vinotify la vérifie à l’enregistrement, puis de nouveau avant chaque livraison.

Le push repose toutefois sur le principe du « meilleur effort ». Il n’y a pas de file de nouvelles tentatives : si votre récepteur est hors service, la livraison est perdue. Le contenu reste disponible pendant 24 heures sur /api/v1/searches/<search_id>/webhook/latest, et le flux d’événements authentifié par bearer sous /api/v1/integrations conserve 48 heures d’historique derrière un curseur. Faites tourner le flux en parallèle du push si vous ne pouvez pas vous permettre de manquer un article, et dédoublonnez avec event_id.

La structure du contenu, le comportement des nouvelles tentatives et des exemples de configuration sont présentés dans le guide d’automatisation par webhooks.

Gardez les limites bien en vue

Vinotify fournit des éléments d’annonce, comme l’heure de capture, le prix demandé et la devise, le titre, l’URL, l’identifiant de l’article et les détails disponibles. Il n’achète pas d’articles, n’exige pas d’identifiants Vinted et ne transforme pas une alerte en vente confirmée. Votre propre workflow peut noter ou mettre en file d’attente des candidats, mais gardez ces décisions séparées de ce que l’événement prouve réellement.

Conservez le token hors du contrôle de version, actualisez la découverte à mesure que vos recherches évoluent, et révoquez le token depuis Intégrations quand vous n’en avez plus besoin. Pour les paramètres exacts, les limites, les champs de réponse et les erreurs, consultez la documentation développeur de Vinotify.