vinted-mcp

Serveur MCP en Rust (SDK rmcp, transport stdio) pour rechercher des articles sur Vinted.

Outils

Outil	Description
search_items	Recherche par mots-clés, avec filtres optionnels : price_min, price_max, catalog_ids, brand_ids, size_ids, status_ids, limit (10 par défaut, 96 max), page, sort (newest_first, price_low_to_high, price_high_to_low, relevance)
get_item	Titre, description, URL et image d'un article à partir de son id ou de son URL

Build

cargo build --release
cargo test

Configuration (Cursor)

Dans ~/.cursor/mcp.json :

{
  "mcpServers": {
    "vinted": {
      "command": "/Users/user/projects/vinted-mcp/target/release/vinted-mcp",
      "env": {
        "VINTED_BASE_URL": "https://www.vinted.fr"
      }
    }
  }
}

Variables d'environnement :

• VINTED_BASE_URL (optionnelle) : marché, par défaut https://www.vinted.fr. https://www.vinted.de, https://www.vinted.co.uk, etc. fonctionnent de la même façon. La devise suit le site (EUR, GBP, USD…).
• VINTED_COOKIE (optionnelle) : valeur du cookie access_token_web, ou en-tête Cookie complet, si la page d'accueil est bloquée.
• VINTED_ANON_ID (optionnelle) : cookie anon_id, à fournir avec VINTED_COOKIE quand l'accueil est bloqué.
• RUST_LOG : niveau de logs (info par défaut), écrits sur stderr.

Le serveur ouvre vinted.fr tout seul pour récupérer une session anonyme. Ce cookie dure environ 24 h et est renouvelé tout seul.

Limites

• Lecture seule : pas d'achat, pas de message, pas de connexion à un compte.
• Usage personnel. L'extraction automatisée est encadrée par les CGU de Vinted.
• Le serveur espace les requêtes d'au moins 1 seconde.
• La recherche utilise l'API interne api.vinted.*/svc-catalogue/items. Elle n'est pas documentée et peut changer sans préavis.
• Le détail d'un article vient des balises Open Graph de la page publique. Le prix, la taille et l'état sont déjà dans le résultat de search_items.