DEV Community

KazKN
KazKN

Posted on • Edited on

How to Query Vinted in Plain English With MCP

#ai #automation #mcp #tutorial

What if you could search Vinted like you'd ask a friend? Not with clunky filters and dropdowns, but with natural language: "Find me a leather jacket, brown, men's medium, under €50, in good condition."

With MCP (Model Context Protocol) and Claude, you can. Here's how.

The Problem With Vinted Search

Vinted's built-in search is decent but limited:

  • You can't combine complex criteria easily
  • No price analytics (average, median, trends)
  • No cross-country comparison
  • No "find me deals" intelligence
  • Can't ask follow-up questions about results

The MCP Solution

The Vinted MCP Server connects Claude to Vinted's marketplace. You type in plain English. Claude understands your intent, calls the right tools, and returns intelligent results.

Setup (Under 5 Minutes) 

npm install -g vinted-mcp-server
Enter fullscreen mode Exit fullscreen mode

Add to Claude Desktop config:

{
  "mcpServers": {
    "vinted": {
      "command": "npx",
      "args": ["-y", "vinted-mcp-server"],
      "env": { "VINTED_COUNTRY": "fr" }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

GitHub | npm | Apify

20 Plain English Queries You Can Try Right Now

Shopping Queries

1. Specific item search

"Find Nike Air Force 1 in size 42, white, under €60"
Enter fullscreen mode Exit fullscreen mode

2. Style-based search

"I'm looking for a minimalist men's wardrobe: 
white t-shirts, black jeans, and a navy jacket. 
All size M/L, under €20 each."
Enter fullscreen mode Exit fullscreen mode

3. Gift hunting

"Find birthday gift ideas for a woman who likes 
vintage fashion, budget €30-50"
Enter fullscreen mode Exit fullscreen mode

4. Outfit matching

"I bought a beige trench coat. Find me accessories 
that would match — scarves, bags, boots — under €25 each"
Enter fullscreen mode Exit fullscreen mode

Deal-Finding Queries

5. Underpriced items

"Search for Patagonia jackets and tell me which 
ones are priced significantly below average"
Enter fullscreen mode Exit fullscreen mode

6. New with tags deals

"Find items that are new with tags but priced 
like used — brands: Cos, Arket, & Other Stories"
Enter fullscreen mode Exit fullscreen mode

7. Bulk deals

"Find sellers on Vinted who have 5+ items of 
men's streetwear in size L. I want to negotiate bundles."
Enter fullscreen mode Exit fullscreen mode

Market Research Queries

8. Price check

"What should I pay for a used PS5 controller on Vinted?"
Enter fullscreen mode Exit fullscreen mode

9. Brand comparison

"Compare prices for Uniqlo vs H&M winter coats 
on Vinted France. Which brand holds value better?"
Enter fullscreen mode Exit fullscreen mode

10. Trend detection

"What's trending on Vinted right now? 
Search for 'Y2K', 'gorpcore', 'quiet luxury', 
and 'old money' — which aesthetic has the most listings?"
Enter fullscreen mode Exit fullscreen mode

Selling Queries

11. Pricing help

"I want to sell a Zara satin midi dress, 
size S, worn once. What should I price it?"
Enter fullscreen mode Exit fullscreen mode

12. Competition analysis

"How many people are selling North Face Nuptse 
jackets in size M on Vinted France right now? 
What's the price range?"
Enter fullscreen mode Exit fullscreen mode

13. Best time to sell

"Is now a good time to sell winter boots on Vinted, 
or should I wait? Check current supply and pricing."
Enter fullscreen mode Exit fullscreen mode

Advanced Queries

14. Cross-country arbitrage

"Find the same Levi's 501 jeans: compare prices 
between Vinted France, Germany, and Netherlands. 
Where should I buy? Where should I sell?"
Enter fullscreen mode Exit fullscreen mode

15. Size availability

"Are Nike Dunks in size 46 rare on Vinted? 
How many are listed and what's the price premium 
compared to common sizes?"
Enter fullscreen mode Exit fullscreen mode

16. Condition impact

"How much does condition affect price for 
Canada Goose parkas? Compare 'new with tags', 
'very good', and 'good'."
Enter fullscreen mode Exit fullscreen mode

17. Brand discovery

"What are some underrated brands on Vinted 
where you can find quality items under €15?"
Enter fullscreen mode Exit fullscreen mode

18. Category deep dive

"Give me a complete market overview of men's 
vintage watches on Vinted France: brands, 
price ranges, popular models."
Enter fullscreen mode Exit fullscreen mode

19. Seasonal planning

"I want to start reselling on Vinted. 
What category should I focus on this month 
based on current demand and margins?"
Enter fullscreen mode Exit fullscreen mode

20. Multi-criteria complex search

"Find designer handbags (Louis Vuitton, Gucci, 
Prada) under €200 in very good condition, 
listed in the last 48 hours on Vinted France. 
Sort by best value."
Enter fullscreen mode Exit fullscreen mode

How It Works Behind the Scenes

When you type a plain English query:

  1. Claude parses your intent — extracts brand, size, price, condition, etc.
  2. Calls the MCP tool — search_vinted with structured parameters
  3. Gets live results — from Vinted's marketplace
  4. Adds intelligence — calculates averages, spots deals, compares options
  5. Responds naturally — organized, actionable results

The Vinted MCP Server handles step 2-3. Claude handles 1, 4, and 5. Together they create a search experience that's 10x more powerful than Vinted's native interface.

Tips for Better Queries

  • Be specific about size: "size 42" beats "medium"
  • Name brands explicitly: "Nike Air Max 90" beats "Nike shoes"
  • State your goal: "I want to buy" vs "I want to sell" changes the analysis
  • Ask follow-ups: "From those results, which 3 would you recommend?"
  • Request comparisons: Claude excels at comparing options
  • Specify country: "on Vinted Germany" for targeted results

Power User: Chain Queries

The real power comes from chaining queries in a conversation:

You: Search for Patagonia fleece jackets on Vinted France
Claude: [returns 25 results with prices]

You: Which of these are at least 30% below average price?
Claude: [identifies 4 potential deals]

You: For those 4, check the seller ratings and listing age
Claude: [adds seller context]

You: Great. Now compare with Germany — are they cheaper there?
Claude: [cross-market comparison]
Enter fullscreen mode Exit fullscreen mode

This conversational flow is impossible with traditional search. You can also scale this with the Apify Vinted Smart Scraper for bulk data needs, or explore other tools in the Apify store.

FAQ

Do I need to learn any syntax or commands?

No. Just type what you want in plain English (or French, German, Spanish — Claude is multilingual). The AI figures out the technical details.

Can I search in French/German/etc?

Yes. "Cherche des vestes en cuir homme taille L moins de 50€" works perfectly.

How accurate are the results?

Results come directly from Vinted's live marketplace — same data you'd see on the website. The AI's analysis (averages, comparisons) is based on this real data.

Can I buy items directly through MCP?

No. MCP is read-only — it searches and analyzes. To buy, click the listing URL in the results.

Is there a limit on queries?

The local npm version has no artificial limits. The Apify hosted version has generous free tier limits.

Start Querying 

npm install -g vinted-mcp-server
Enter fullscreen mode Exit fullscreen mode

👉 npm
👉 Apify
👉 GitHub

Your words. Real results. No filters needed.

Top comments (0)