🛍️ Vinted MCP & CLI Server
Give your AI assistant access to Vinted — search, compare prices, and track sellers across 19 countries.
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @googlarz/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add googlarz-vinted-mcp-cli -- npx -y @googlarz/vinted-client@1.6.3รันในเทอร์มินัล
{ "mcpServers": { "googlarz-vinted-mcp-cli": { "command": "npx", "args": [ "-y", "@googlarz/[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดVinted has no public API. This package bridges that gap — it lets AI assistants talk directly to Vinted via the Model Context Protocol.
Connect it to Claude, Cursor, or any MCP-compatible assistant and just ask:
"Find me a North Face jacket under €60 in Germany, good condition or better"
"Compare prices for Air Jordan 1s across France, Italy and the UK"
"What is seller #123456 currently selling? Anything under €20?"
The AI figures out which filters to use, calls Vinted, and gives you a real answer — no searching, no filtering, no tabs.
Also ships as a CLI tool and TypeScript library for direct use.
An MCP server, CLI tool, and TypeScript library for the Vinted secondhand marketplace. No official API — it bootstraps a session cookie from the public catalog page and calls the private JSON API the Vinted web app uses internally.
opSearch, opCompare, etc. directly in your codenpm install -g @googlarz/vinted-client
Or run without installing:
npx -y -p @googlarz/vinted-client vinted search "levis 501"
# Search (JSON by default)
vinted search "levi's 501" --country fr
# Pretty table
vinted search "levi's 501" --country de --output table
# Filter by price, brand, condition
vinted search "adidas samba" \
--price-min 20 --price-max 80 \
--brand adidas \
--condition new_with_tags,very_good \
--output table
# Watch for new listings every 30s (minimum 5)
vinted search "air jordan 1" --watch 30
# Walk all pages and collect up to 500 results
vinted search "vintage denim" --all --max-items 500
# Get a specific item (ID or URL)
vinted item 1234567
vinted item https://www.vinted.fr/items/1234567
# Seller profile + active listings
vinted seller 987654
vinted seller-items 987654 --output table
# Cross-country price comparison (6 countries by default)
vinted compare "north face jacket" --output table
# Browse category tree
vinted categories --query shoes --output table
# Look up brand IDs
vinted brands "stone island"
# What's trending right now
vinted trending --country fr --output table
# Resolve size labels to IDs, or let search do it for you
vinted sizes M L XL --country de
vinted search "levi 501" --size M,L
vinted search "levi 501" --size-ids 206,207,208
# Filter by color (name auto-resolved)
vinted search "north face jacket" --color black --country fr
# Cross-country compare with filters (size M only)
vinted compare "adidas samba" --size-ids 103 --all-countries --output table
# Seller due-diligence
vinted feedback 987654 --country fr --output table
# Browse colors and size groups
vinted colors --output table
vinted size-groups --output table
Result limits. Vinted serves search results in fixed pages of 96, so
--limitonly truncates a page, and at most 960 results are reachable per query. Search results carry the listing's brand, size and condition as Vinted displays them (localised to the country site, e.g. "Très bon état") and the seller's numeric ID but not the username — usevinted item <id>orvinted seller <id>for that. Vinted's catalog has no date filter, so there is no--date-from/--date-to; use--sort newest_first.
fr de uk it es nl pl pt be at lt cz sk hu ro hr fi dk se
Drop Vinted into any MCP-compatible AI assistant (Claude, Cursor, etc.).
Add to claude_desktop_config.json:
{
"mcpServers": {
"vinted": {
"command": "npx",
"args": ["-y", "-p", "@googlarz/vinted-client", "vinted-mcp"]
}
}
}
claude mcp add vinted -- npx -y -p @googlarz/vinted-client vinted-mcp
Brand, size and color names passed to search_items, search_all_items, get_new_items and compare_prices are resolved automatically. If none of the names resolve the call fails (rather than silently searching unfiltered); if only some do, the result includes a warnings array. Browser mode for get_item is not available to MCP callers — the server operator enables it with VINTED_BROWSER=1.
By default the server speaks stdio. For a network transport:
VINTED_MCP_TRANSPORT=http VINTED_MCP_TOKEN=choose-a-long-random-secret npx -y -p @googlarz/vinted-client vinted-mcp
# listens on http://127.0.0.1:3001/mcp — send `Authorization: Bearer <token>`
Without VINTED_MCP_TOKEN the server only accepts loopback Host headers and rejects browser (Origin) requests, and it refuses to bind to a non-loopback VINTED_MCP_HOST. Set a token whenever the port is reachable by anything you don't fully trust.
Built-in prompt templates for common workflows — use them from any MCP-compatible client:
Example prompts once connected:
"Find me Nike Air Max 95s under €70 in Germany, size 43, very good condition"
"Compare prices for a North Face puffer jacket across France, Germany and Italy"
"Is seller #987654 trustworthy? Check their reviews and listings."
"Find black Levi's 501 jeans size 32 — use the wardrobe-hunt prompt"
import { VintedClient, opSearch, opCompare, opSearchAll, opGetNewItems } from '@googlarz/vinted-client';
const client = new VintedClient();
// Basic search
const results = await opSearch(client, {
query: 'levi\'s 501',
country: 'de',
priceMax: 50,
condition: ['very_good', 'good'],
sortBy: 'price_low_to_high',
});
console.log(results.items);
// Collect all pages concurrently (3-page prefetch window)
const all = await opSearchAll(client, {
query: 'vintage band tee',
country: 'uk',
maxItems: 300,
});
// Multi-country price comparison (report.failed lists countries that errored)
const report = await opCompare(client, {
query: 'air jordan 1 retro',
countries: ['fr', 'de', 'uk', 'it'],
});
// Poll for new listings: keep the cursor between calls
let cursor: number | undefined;
const fresh = await opGetNewItems(client, { query: 'air jordan 1', country: 'fr', afterId: cursor });
cursor = fresh.latestId ?? cursor;
const client = new VintedClient({
proxyUrl: 'http://proxy:8080', // or VINTED_PROXY_URL env var
cacheTtlMs: 60_000, // response cache TTL (0 = disable)
rateLimitPerSec: 3, // requests/sec per country
rateLimitBurst: 6, // burst capacity
timeoutMs: 20_000, // per-request timeout
});
Vinted has no public API. This library:
vinted.{cc}/catalog and capturing the auth cookies the Vinted frontend sets (one bootstrap per country, shared by concurrent requests)./catalog page embeds the result list in its Next.js payload, which is parsed here. Sellers, feedback, brands, colors and sizes still come from the private JSON API (/api/v2/...).opSearchAll to maximise throughput within the rate-limit budget.If Vinted blocks your IP (common on cloud VMs and CI), set a proxy:
VINTED_PROXY_URL=http://user:pass@proxy:8080 vinted search "nike"
# or
vinted search "nike" --proxy http://user:pass@proxy:8080
Standard HTTPS_PROXY / HTTP_PROXY env vars are also respected.
playwright + puppeteer-extra-plugin-stealth for --browser / VINTED_BROWSER=1 modeMIT © googlarz
Browse, search, and manage Vinted listings from Claude or the terminal — buy, sell, track items, and automate your secondhand workflow
{ "mcpServers": { "googlarz-vinted-mcp-cli": { "command": "npx", "args": [ "-y", "@googlarz/[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Vinted MCP Cli ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-27 Browse, search, and manage Vinted listings from Claude or the terminal — buy, sell, track items, and automate your secondhand workflow