Token导航 LogoToken导航TokenDH.com
Vinted MCP logo
AI代理未说明官方级别未说明来源级核验

Vinted MCP

MCP Server

用于Vinted平台商品搜索、卖家分析、价格比较和趋势商品展示的MCP服务器。

工具数

5

提示词数

0

GitHub Stars

0

资源数

0
TypeScriptClaudeAI代理ClaudeCursorWindsurfCline

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

andrijdavid

提供方

andrijdavid

最后核验

2026/5/17 20:23

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

详细介绍

认证MCP服务器

](https://www.npmjs.com/package/@andrijdavid/vinted-mcp) ![License: AGPL v3+](./LICENSE.md)

用于Vinted搜索和分析的MCP服务器,提供搜索列表、获取商品详细信息、检查卖家资料、比较各国价格和展示趋势商品的工具。

它还公开了受支持国家和类别数据的资源。

免责声明:本项目与Vinted或其任何子公司或附属公司没有附属关系、关联关系、授权、背书,也没有以任何方式正式联系。Vinted官方网站可以在 vinted.com.

客户端支持

此服务器与支持本地 stdio 服务器。

热门客户端和设置文档:

  • 克劳德桌面(本地):https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop
  • 克劳德桌面(远程):https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
  • ChatGPT(MCP开发者模式):https://platform.openai.com/docs/guides/developer-mode
  • ChatGPT(MCP和连接器):https://platform.openai.com/docs/guides/tools-remote-mcp
  • 光标:https://docs.cursor.com/context/model-context-protocol
  • 风浪:https://docs.windsurf.com/windsurf/cascade/mcp
  • 克莱恩:https://docs.cline.bot/mcp/configuring-mcp-servers
  • 完整的MCP客户端目录:https://modelcontextprotocol.io/clients

快速启动

选项1:npx

将此添加到您的MCP客户端配置中:

{
  "mcpServers": {
    "vinted": {
      "command": "npx",
      "args": ["-y", "@andrijdavid/vinted-mcp"]
    }
  }
}

选项1b:双层床(金丝雀)

bunx @andrijdavid/vinted-mcp@next

这将在中启动服务器 stdio 模式并等待MCP客户端。

选项2:全局安装

npm install -g @andrijdavid/vinted-mcp

然后配置:

{
  "mcpServers": {
    "vinted": {
      "command": "vinted-mcp"
    }
  }
}

在网络模式下运行(基于TCP的流式HTTP)

如果您需要一个网络端点而不是stdio,请运行:

VINTED_MCP_TRANSPORT=http VINTED_MCP_HOST=127.0.0.1 VINTED_MCP_PORT=3001 bunx @andrijdavid/vinted-mcp@next

可选:

  • VINTED_MCP_PATH (默认值 /mcp)
  • VINTED_MCP_ENABLE_LEGACY_SSE (默认值 true)
  • VINTED_MCP_LEGACY_SSE_PATH (默认值 /sse)
  • VINTED_MCP_LEGACY_MESSAGES_PATH (默认值 /messages)

默认端点:

  • 流式HTTP(推荐): http://127.0.0.1:3001/mcp
  • 传统SSE(老客户): http://127.0.0.1:3001/sse

CLI使用和环境变量

内联传递env变量(macOS/Linux)

VINTED_AUTH_MODE=env \
VINTED_AUTH_COOKIES='session_cookie=your_value; other_cookie=your_value' \
VINTED_AUTH_CSRF_TOKEN='your_csrf_token' \
bunx @andrijdavid/vinted-mcp@next

内联传递env变量(PowerShell)

$env:VINTED_AUTH_MODE = "env"
$env:VINTED_AUTH_COOKIES = "session_cookie=your_value; other_cookie=your_value"
$env:VINTED_AUTH_CSRF_TOKEN = "your_csrf_token"
bunx @andrijdavid/vinted-mcp@next

内联传递env变量(Windows命令提示符)

set VINTED_AUTH_MODE=env
set VINTED_AUTH_COOKIES=session_cookie=your_value; other_cookie=your_value
set VINTED_AUTH_CSRF_TOKEN=your_csrf_token
bunx @andrijdavid/vinted-mcp@next

使用本地 .env 文件

服务器自动加载 .env 从当前工作目录。

cp .env.example .env
bunx @andrijdavid/vinted-mcp@next

使用env从CLI运行网络模式

VINTED_MCP_TRANSPORT=http \
VINTED_MCP_HOST=127.0.0.1 \
VINTED_MCP_PORT=3001 \
bunx @andrijdavid/vinted-mcp@next

Windows命令提示符:

set VINTED_MCP_TRANSPORT=http
set VINTED_MCP_HOST=127.0.0.1
set VINTED_MCP_PORT=3001
bunx @andrijdavid/vinted-mcp@next

身份验证和环境

服务器自动加载 .env 如果存在,请从工作目录中删除。

从示例文件开始:

cp .env.example .env

主要变量:

  • VINTED_AUTH_MODE: http, playwright,或 env
  • VINTED_AUTH_COOKIES:cookie头字符串或JSON对象字符串
  • VINTED_AUTH_CSRF_TOKEN:CSRF令牌
  • VINTED_AUTH_ACCESS_TOKEN:可选不记名代币
  • VINTED_PROXY_URL:可选代理URL
  • VINTED_MAX_CONCURRENCY:可选调整
  • VINTED_REQUEST_DELAY_MS:可选调整
  • VINTED_MAX_RETRIES:可选调整

带有env-auth的客户端配置示例:

{
  "mcpServers": {
    "vinted": {
      "command": "npx",
      "args": ["-y", "@andrijdavid/vinted-mcp"],
      "env": {
        "VINTED_AUTH_MODE": "env",
        "VINTED_AUTH_COOKIES": "session_cookie=your_value; other_cookie=your_value",
        "VINTED_AUTH_CSRF_TOKEN": "your_csrf_token"
      }
    }
  }
}

如何获取Cookie和CSRF令牌

  1. 在浏览器中登录Vinted。
  2. 打开开发人员工具。
  3. 打开 Network 并刷新。
  4. 打开任意 https://www.vinted./api/... 请求。
  5. 复制自 Request Headers:

- cookie -> VINTED_AUTH_COOKIES - x-csrf-token -> VINTED_AUTH_CSRF_TOKEN

  1. 可选:复制 authorization: Bearer ... 令牌进入 VINTED_AUTH_ACCESS_TOKEN.

安全注意事项:

  • 将这些价值观视为秘密
  • 永不承诺 .env
  • 如果暴露,则旋转令牌/Cookie

工具

search_items

使用国家、价格范围、品牌ID、类别、条件、排序和限制等过滤器搜索列表。

get_item

按以下方式获取项目详细信息 itemIdurl.

get_seller

通过以下方式获取卖家资料数据和可选的最新商品 sellerIdurl.

compare_prices

比较各国查询的平均价格和中位数价格。

get_trending

按参与度得分返回趋势项目。

资源

  • vinted://countries
  • vinted://categories

资源模板

  • vinted://item/{country}/{itemId}
  • vinted://seller/{country}/{sellerId}
  • vinted://search/{country}/{query}

这些模板允许客户端快速创建直接资源URI。

提示模板

  • find_best_deal
  • screen_seller
  • search_item_with_filters
  • trending_report
  • buy_or_skip_decision
  • resale_arbitrage_estimator

这些预定义的提示帮助客户端引导常见的Vinted工作流。

支持的国家: fr, de, uk, it, es, nl, pl, pt, be, at, lt, cz, sk, hu, ro, hr, fi, dk, se.

本地开发

npm install
npm run build
npm run bundle
npm start

测试

运行协议级测试:

npm test

运行实时集成测试:

RUN_LIVE_MCP_TESTS=1 npm test

许可证

根据以下许可 AGPL-3.0-or-later.

LICENSE.md.

目录标签

目录标签

TypeScriptClaudeAI代理二手交易分析本地部署价格比较工具卖家分析趋势商品发现MCP协议

支持客户端

ClaudeCursorWindsurfCline

接入字段

传输方式(transport,传输协议)

未说明

鉴权方式(authType,认证方式)

token

工具数量(toolCount,工具数)

5

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

未说明token部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

仍需确认:installCommand

来源信息

继续浏览同类 MCP