vinted-mcp-server Server
Primer servidor MCP para el marketplace Vinted. Busca millones de artículos de segunda mano, compara precios en 19 países (FR, DE, ES, IT, NL, BE, UK...), analiza perfiles de vendedores con valoraciones y estado de verificación, detecta oportunidades de arbitraje entre países y rastrea productos en tendencia. 5 herramientas: search_items, get_item, get_seller, compare_prices, get_trending. 2 recursos: lista de países, categorías. Funciona con Claude Desktop, Cursor, Windsurf y cualquier cliente compatible con MCP. Sin configuración — solo npx.
Documentación
🛍️ Vinted MCP Server — Search, Compare Prices & Analyze Sellers
The first MCP server for the Vinted marketplace. Give your AI assistant the power to search 800M+ listings, compare prices across 19 countries, and analyze seller profiles — all through the Model Context Protocol.
Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP-compatible client.
⚡ Quick Start
Option 1: npx (zero install)
{ "mcpServers": { "vinted": { "command": "npx", "args": ["-y", "vinted-mcp-server"] } } }
Option 2: Global install
npm install -g vinted-mcp-server
Then add to your MCP client config:
{ "mcpServers": { "vinted": { "command": "vinted-mcp-server" } } }
🔧 Client Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Cursor
Settings → MCP Servers → Add:
🛠️ Tools (5)
search_items
Search Vinted listings with powerful filters.
| Parameter | Type | Description |
|---|---|---|
| query | string | Search keywords (required) |
| country | string | Country code — fr, de, uk, it, es, nl, pl, pt, be, at, lt, cz, sk, hu, ro, hr, fi, dk, se |
| priceMin | number | Minimum price |
| priceMax | number | Maximum price |
| brandIds | number[] | Filter by brand IDs |
| categoryId | number | Vinted category ID |
| condition | string[] | new_with_tags, new_without_tags, very_good, good, satisfactory |
| sortBy | string | relevance, price_low_to_high, price_high_to_low, newest_first |
| limit | number | Max results (up to 100) |
Example prompt: "Search for Nike Air Max on Vinted France under 50€, sort by price"
get_item
Get full details for a specific Vinted item by ID.
| Parameter | Type | Description |
|---|---|---|
| itemId | number | Vinted item ID (required) |
| country | string | Country code |
Example prompt: "Get details for Vinted item 4283719503"
get_seller
Analyze a Vinted seller's profile, ratings, and recent items.
| Parameter | Type | Description |
|---|---|---|
| sellerId | number | Vinted seller ID (required) |
| country | string | Country code |
Example prompt: "Show me the profile of seller 12345678 on Vinted Germany"
compare_prices
Compare prices for an item across multiple Vinted countries.
| Parameter | Type | Description |
|---|---|---|
| query | string | Search keywords (required) |
| countries | string[] | Countries to compare (default: all) |
| limit | number | Items per country |
Example prompt: "Compare prices for 'Levi's 501' across France, Germany, and Italy"
get_trending
Discover trending items on Vinted.
| Parameter | Type | Description |
|---|---|---|
| country | string | Country code |
| categoryId | number | Optional category filter |
| limit | number | Number of trending items |
Example prompt: "What's trending on Vinted Netherlands right now?"
📚 Resources (2)
vinted://countries
Returns the full list of 19 supported Vinted countries with domain, currency, and language info.
vinted://categories
Returns the Vinted category tree for filtering searches.
🌍 Supported Countries (19)
| Code | Country | Currency |
|---|---|---|
| fr | France | EUR |
| de | Germany | EUR |
| uk | United Kingdom | GBP |
| it | Italy | EUR |
| es | Spain | EUR |
| nl | Netherlands | EUR |
| be | Belgium | EUR |
| at | Austria | EUR |
| pl | Poland | PLN |
| pt | Portugal | EUR |
| lt | Lithuania | EUR |
| cz | Czech Republic | CZK |
| sk | Slovakia | EUR |
| hu | Hungary | HUF |
| ro | Romania | RON |
| hr | Croatia | EUR |
| fi | Finland | EUR |
| dk | Denmark | DKK |
| se | Sweden | SEK |
💡 Use Cases
- 🛒 AI Shopping Assistant — "Find me a winter jacket under 30€ in good condition"
- 📊 Price Analysis — "What's the average price for PS5 controllers across Europe?"
- 💰 Arbitrage — "Find items priced lower in Poland that I can buy from France"
- 👤 Seller Research — "Is this seller trustworthy? Show me their ratings and history"
- 📈 Trend Watching — "What's trending in fashion on Vinted Germany?"
🔗 Related
Looking for programmatic scraping at scale? Check out the Vinted Smart Scraper on Apify — same engine, cloud-scale.
📄 License
MIT © KazKN