Vinted

vinted-mcp

Vintedで中古品の出品を検索するMCP サーバーです。Claude（または任意のMCPクライアント）が「中古のXはいくらくらい？」という質問に回答できます。

匿名で読み取り専用です。 ログインやアカウントは不要で、書き込みもありません。検索のみを行います。Vintedとは提携していません。

ツール

search

任意のフィルターを指定して出品を検索します。一致した件数の合計と、1ページ分の出品を返します。

パラメーター：

• query — 検索キーワード（例："nike air max 90"、"vestido zara"）
• price_min / price_max — EURでの価格範囲
• sort — "relevance"（デフォルト） | "cheap" | "expensive" | "newest"
• page — ページ番号（デフォルトは1）
• per_page — 1ページあたりの結果数（デフォルトは24、最大96）

各出品には、タイトル、価格、Vintedの購入者保護手数料込みの価格（送料は別途）、ブランド、サイズ、状態、リンク、写真、販売者が事業者かどうか、お気に入り数が含まれます。

ヒント："cheap"では、関連性が低い出品も表示されます。「Xの最安値」を探すには、デフォルトの関連性順で並べ替え、price_maxを指定してください。

インストール

最も簡単な方法（uvが必要）：クローンは不要で、PyPIから直接実行できます。

claude mcp add vinted -- uvx vinted-search-mcp

Claude Desktopでは、"command": "uvx", "args": ["vinted-search-mcp"]を使用してください。

ソースからインストール：

Python 3.10以降が必要です。

git clone https://github.com/ThiagoJacobLannes/vinted-mcp
cd vinted-mcp
python -m pip install -e .

Windowsで、コードをクラウド同期フォルダー（Google Drive、OneDrive）に保存する場合は、仮想環境をその外に作成してください。同期クライアントがフォルダーにdesktop.iniファイルを作成し、パッケージの起動時にクラッシュすることがあります。

Claude Codeに追加

claude mcp add vinted -- python -m vinted_mcp.server

Claude Desktopに追加

claude_desktop_config.snippet.jsonの内容をClaude Desktopのclaude_desktop_config.jsonにマージし、Claude Desktopを再起動してください。

{
  "mcpServers": {
    "vinted": {
      "command": "python",
      "args": ["-m", "vinted_mcp.server"]
    }
  }
}

その他の国

デフォルトはポルトガルです。VINTED_BASE_URLに別のVintedドメイン（例：https://www.vinted.frやhttps://www.vinted.es）を設定すると、その地域を検索できます。

仕組み

Vintedには公式APIがありません。このサーバーは、検索内容に応じたVintedの公開カタログページを読み込み、ページに含まれている検索結果を読み取ります（結果はReact Server Componentのデータとして返されます）。Vintedがページを変更した場合、誤ったデータを返す代わりに、内容が明確な{"error": ...}を返してツールが失敗します。

ライセンス

MIT