googlarz/vinted-mcp-cli

Дайте своему помощнику ИИ доступ к Vinted - поиск, сравнение цен и отслеживание продавцов в 19 странах.

##Идея

Vinted не имеет публичного API. Этот пакет устраняет этот разрыв — он позволяет помощникам ИИ напрямую общаться с Vinted через протокол Model Context.

Подключите его к Claude, Cursor или любому MCP-совместимому помощнику и просто спросите:

«Найди мне куртку под 60 евро в Германии, в хорошем состоянии или лучше»

Сравните цены на Air Jordan 1s во Франции, Италии и Великобритании.

Что продает продавец #123456 в настоящее время? Что-нибудь под 20 евро?

ИИ выясняет, какие фильтры использовать, вызывает Vinted и дает вам реальный ответ — никакого поиска, никакой фильтрации, никаких вкладок.

Также поставляется как инструмент CLI и библиотека TypeScript для прямого использования.

##Что это такое?

Сервер MCP, инструмент CLI и библиотека TypeScript для вторичного рынка Vinted. Нет официального API — он загружает сеансовый файл cookie со страницы публичного каталога и вызывает частный JSON API, который веб-приложение Vinted использует внутри.

MCP-сервер — подключитесь к Claude, Cursor или любому помощнику AI с поддержкой MCP

---

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