mcpField
V
Vinted

Vinted

本地服务
thiagolannes.com搜索与检索05 天前更新
代码仓库访问官网

关于 Vinted

Vinted 是一个面向 MCP 客户端的只读服务，可匿名搜索 Vinted 上的二手商品。它支持关键词、欧元价格范围、排序和分页，并返回商品及卖家相关信息。

主要功能

  1. 01匿名搜索 Vinted 商品
  2. 02按欧元价格范围筛选
  3. 03按相关度、价格或上新时间排序
  4. 04分页查看商品结果
  5. 05返回商品与卖家信息

适用场景

  1. 01查询二手商品的当前标价
  2. 02按预算筛选特定商品
  3. 03比较不同商品的品牌、尺码和成色
  4. 04在其他 Vinted 国家站点搜索商品

MCP 相关

它向 MCP 客户端提供搜索工具，可查询 Vinted 商品列表及其价格、品牌、尺码、成色和链接等信息。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "thiagojacoblannes-vinted": {
      "command": "uvx",
      "args": [
        "vinted-search-mcp"
      ]
    }
  }
}
启动命令uvx vinted-search-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypivinted-search-mcp0.1.0

工具

1

收录的工具列表 · 更新于 1 周前

参数类型必填说明
pageinteger否
sortstring否
querystring是
per_pageinteger否
price_maxany否
price_minany否

详细介绍

vinted-mcp

用于搜索 Vinted 二手商品列表的 MCP 服务，让 Claude（或任何 MCP 客户端）都能回答“二手 X 大概卖多少钱？”

匿名且只读。 无需登录或账户，不会执行写入操作：只搜索。与 Vinted 无关联。

工具

search

搜索商品列表，可选择添加筛选条件。返回匹配总数和一页商品列表。

参数：

  • query — 搜索关键词（例如 "nike air max 90"、"vestido zara"）
  • price_min / price_max — 价格范围，单位为欧元
  • sort — "relevance"（默认）| "cheap" | "expensive" | "newest"
  • page — 页码（默认值为 1）
  • per_page — 每页结果数（默认值为 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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。