Browse, search, and manage Vinted listings from Claude or the terminal — buy, sell, track items, and automate your secondhand workflow
概览
Vinted has no public API. This package bridges that gap — it lets 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. An , , and 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. - 🤖 — plug into Claude, Cursor, or any AI assistant with MCP support - 🖥️ — pipe results, watch for new listings, compare prices from your terminal - 📦 — import opSearch, opCompare, etc. directly in your code
README
以下为原文 README 节选，完整内容请查看原文。
The idea
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.
What is this?
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.
- 🤖 MCP server — plug into Claude, Cursor, or any AI assistant with MCP support
- 🖥️ CLI tool — pipe results, watch for new listings, compare prices from your terminal
- 📦 TypeScript library — import
opSearch,opCompare, etc. directly in your code
Install
npm install -g @googlarz/vinted-client
Or run without installing:
npx -y -p @googlarz/vinted-client vinted search "levis 501"
CLI Quick Start
# 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安装
npx -y -p @googlarz/vinted-client vinted-mcp配置
{
"mcpServers": {
"vinted": {
"command": "npx",
"args": ["-y", "-p", "@googlarz/vinted-client", "vinted-mcp"]
}
}
}