vinted-mcp-server Server
Server MCP pertama untuk marketplace Vinted. Cari jutaan barang bekas, bandingkan harga di 19 negara (FR, DE, ES, IT, NL, BE, UK...), analisis profil penjual dengan rating dan status verifikasi, deteksi peluang arbitrase antar negara, dan lacak produk tren. 5 alat: search_items, get_item, get_seller, compare_prices, get_trending. 2 sumber daya: daftar negara, kategori. Bekerja dengan Claude Desktop, Cursor, Windsurf, dan klien kompatibel MCP lainnya. Tanpa konfigurasi — cukup npx.
Dokumentasi
🛍️ 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