Poshmark Comps

@pipeworx/poshmark-comps

在公开的 Poshmark 市场中搜索已售商品价格和在售商品—— 这是 Poshmark 上最好的公开已售价格参考数据，无需登录，也无需 API 密钥。

属于 Pipeworx — 一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

• poshmark_sold_search(query, department?, sort_by?, limit?) — 搜索已售 商品，针对每条结果返回价格、尺码、品牌、成色、售出日期、卖家和 商品链接。
• poshmark_active_search(query, department?, sort_by?, limit?) — 返回格式相同， 搜索当前在售（尚未售出）的商品，以便比较标价和已售价格。

身份验证

无需密钥。无需登录，无需 API 密钥，也未遇到反机器人验证挑战（已于 2026-09-05 实时验证）。

数据源

• https://poshmark.com/search — Poshmark 自己的公开搜索页面。它没有单独的 JSON API 端点：页面由 Vue 应用在服务器端渲染，并在 window.__INITIAL_STATE__ 脚本标签数据块中嵌入完整结果集（实时检查：XHR/Accept: application/json 请求返回的仍是完整 HTML 页面，而不是 JSON）。此工具包会获取该 HTML 并直接提取 嵌入的 JSON，比解析 DOM 更省资源，也更稳健。

给后续维护者的注意事项：

• 每次调用获取一页，最多约 48 条结果（Poshmark 自己的默认页大小）。 响应中的 next_max_id 是有效的分页游标，但此工具包目前不会继续翻页——工具 输出中的 total_matches_reported_by_poshmark 会告知调用方还有多少条结果。
• 已售商品的 price 是 Poshmark 在已售商品帖中显示的商品标价（卖家当时的 要价），并非单独核实过的收据金额或成交价，且不含 Poshmark 的费用和运费。请向调用方说明这一点—— 每个响应的 coverage_note 中都有说明。
• sort_by 只有 best_match（默认值）、price_desc 和 price_asc 能可靠使用——实时测试时，newest 和 most_loved 返回了空结果集， 因此未将其作为选项提供。
• 实时测试时，网站上的 brand/size 查询参数无法可靠筛选 （结果中包含不匹配的品牌）；真正起筛选作用的是自由文本 query，因此没有将品牌和尺码作为单独参数提供——请将它们写进 query 中（例如 "lululemon align size 6"）。
• 请礼貌地抓取数据：每次工具调用只获取一页，不循环翻页，也不并发分发请求。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "poshmark-comps": {
      "url": "https://gateway.pipeworx.io/poshmark-comps/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/poshmark-comps/mcp 上的 tools/list 会返回上表中的工具， 以及共享的 Pipeworx 元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关范围内的其他工具。因此，你看到的工具数量会多于本表：单个工具包端点目前会列出约 30 个共享工具，以及 此工具包自有的工具。连接的 initialize 响应会说明其确切范围，也是了解当天实际情况的权威依据。

这是有意为之，并非意外复用。元工具让限定范围的连接能够回答此工具包未涵盖的问题——通过 ask_pipeworx 路由到整个目录——无需添加第二个 MCP 服务。目前无法在不包含这些元工具的情况下挂载工具包端点；如果额外的架构定义所占用的上下文超出了路由功能带来的价值， 请连接一次完整网关，而不是连接多个工具包端点。

也可以连接到完整的 Pipeworx 网关，直接列出所有工具包的工具， 而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会访问同一个网关和相同的 1683+ 个数据源。唯一的区别是哪些工具包的工具会被 直接列出；无论使用哪个 URL，ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/poshmark_sold_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"lululemon align","sort_by":"relevance","limit":10}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/poshmark_sold_search。查找工具：POST https://gateway.pipeworx.io/v1/tools/search_packs，并传入 {"query":"..."}。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "poshmark-comps": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-poshmark-comps"]
    }
  }
}

或者直接运行，确认它能够启动：

npx -y @pipeworx/mcp-poshmark-comps

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，但仅提供此软件包的工具——不包含上方网关连接所添加的任何共享元工具。相同的源代码，相同的工具，无 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的语言提问，而不是直接调用工具——这在上方的软件包端点和完整网关上都适用：

ask_pipeworx({ question: "your question about Poshmark Comps data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT