googlarz/vinted-mcp-cli

** Vinted의 AI 보조 액세스 - 19 개국의 검색, 비교 가격 및 추적 판매자. **

---

아이디어

Vinted는 공개 API가 없습니다. 이 패키지 브리지 그 간격 — 그것은 하자 AI 조수는 모델 Context 프로토콜을 통해 Vinted에 직접 이야기.

Claude, Cursor, 또는 MCP 호환 보조에 연결하고 그냥 요청 :

• "독일, 좋은 상태 또는 더 나은"에서 € 60 미만의 북 페이스 재킷을 Find *

• “프랑스, 이탈리아 및 영국 전역의 Air Jordan 1s 가격”*

• "현재 판매중인 판매자 #123456는 무엇입니까? € 20의 밑에 아무것도? *

필터를 사용하여, Vinted 호출, 그리고 당신에게 실제 대답을 제공 - 검색, 필터링 없음, 탭 없음.

CLI 도구 및 TypeScript 라이브러리로 배송합니다.

---

이것은 무엇입니까?

MCP 서버, CLI 도구, TypeScript 라이브러리 공식 API 없음 - 공개 카탈로그 페이지에서 세션 쿠키를 부트 스트랩하고 개인 JSON API를 호출하여 Vinted 웹 앱은 내부적으로 사용합니다.

• MCP 서버 ** - Claude, Cursor 또는 MCP 지원과 AI Assistant에 플러그

---

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