Secondhand MCP

一个模型上下文协议 (MCP) 服务器，让 AI 助手能够搜索二手市场。搜索 Facebook Marketplace、eBay、Depop 和 Poshmark 上的二手商品——按价格、类别、成色、尺码和颜色筛选，然后获取包含照片、描述和卖家信息的完整商品详情。

适用于 Claude Desktop、Claude Code、Cursor 以及任何兼容 MCP 的客户端。

[!TIP] 想跳过设置？ 试试 Secondhand MCP Cloud——托管版本，30 秒内即可连接到 Claude.ai 和 ChatGPT。无需安装或 Chrome。包含免费套餐。

支持的市场

Related MCP server: BopMarket MCP Server

设置

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "secondhand": {
      "command": "npx",
      "args": ["-y", "secondhand-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your-ebay-client-id",
        "EBAY_CLIENT_SECRET": "your-ebay-client-secret",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

Claude Code

添加到 ~/.claude/.mcp.json：

{
  "mcpServers": {
    "secondhand": {
      "command": "npx",
      "args": ["-y", "secondhand-mcp"],
      "env": {
        "EBAY_CLIENT_ID": "your-ebay-client-id",
        "EBAY_CLIENT_SECRET": "your-ebay-client-secret",
        "EBAY_MARKETPLACE_ID": "EBAY_US"
      }
    }
  }
}

eBay、Depop 和 Poshmark 都是可选的——如果缺少 eBay API 密钥或未安装 Chrome，这些市场会自动禁用，其余市场仍可正常工作。

Depop 和 Poshmark / Chrome 要求

Depop 和 Poshmark 需要无头浏览器。如果您的系统上安装了 Google Chrome 或 Chromium，两者都会自动启用——无需配置。如果未找到 Chrome，它们会被静默跳过。

在 macOS 上，首次搜索 Depop 或 Poshmark 时，您可能会看到系统提示，要求允许 Node.js 控制 Chrome。这是预期的行为——puppeteer 需要以无头模式启动 Chrome。允许一次后，就不会再询问。

浏览器在后台不可见地运行，仅在您实际搜索 Depop 或 Poshmark 时启动。

配置

选择市场

默认情况下，所有市场都已启用。要限制哪些市场处于活动状态，请设置 MARKETPLACES 环境变量（逗号分隔）：

{
  "env": {
    "MARKETPLACES": "facebook,ebay"
  }
}

有效值：facebook、ebay、depop、poshmark

eBay API 密钥

eBay 使用官方的 Browse API。您需要一个免费的 eBay 开发者账户：

1. 在 developer.ebay.com 创建一个账户

2. 创建一个应用程序以获取客户端 ID 和客户端密钥

3. 将它们作为 EBAY_CLIENT_ID 和 EBAY_CLIENT_SECRET 添加到您的 MCP 配置中

eBay 市场/区域

默认情况下，服务器针对 美国 eBay 网站。要搜索不同的区域市场，请设置 EBAY_MARKETPLACE_ID 环境变量：

{
  "env": {
    "EBAY_MARKETPLACE_ID": "EBAY_DE"
  }
}

常见值：

完整列表可在 eBay API 文档 中找到。

工具

search_marketplace

跨市场搜索商品。

每个市场返回的数据：

get_listing_details

使用搜索结果中的 ID 获取特定商品的完整详情。

每个市场返回的数据：

list_marketplaces

列出所有已启用的市场及其状态。

search / fetch（深度研究）

遵循 ChatGPT 深度研究工具合约 的便捷配对——确切名称，每个参数为单个字符串：

• search(query)——同时搜索所有已启用的市场，返回 { results: [{ id, title, text, url }] }，其中 id 为 marketplace:listingId

• fetch(id)——返回 search 结果 ID 的完整商品详情，格式为 { id, title, text, url, metadata }

适用于期望这些标准工具名称的研究型客户端；如需筛选搜索，请使用 search_marketplace。

工作原理

Facebook Marketplace——按位置、价格和搜索词搜索商品。将城市名称解析为坐标。无需登录或浏览器。

eBay——使用官方的 eBay Browse API，采用 OAuth 2.0 客户端凭据。令牌会被缓存并自动刷新。目标区域市场由 EBAY_MARKETPLACE_ID 控制（默认：EBAY_US）。

Depop——使用无头浏览器搜索商品，支持类别、成色、尺码和颜色筛选。浏览器实例在请求之间共享。

Poshmark——使用无头浏览器搜索商品，支持成色、尺码、颜色、排序和价格筛选。Poshmark 不基于位置——所有商品全国配送。

开发

git clone https://github.com/jlsookiki/secondhand-mcp.git
cd secondhand-mcp
npm install
npm run build

添加市场

1. 在 src/marketplaces/ 中创建一个新文件

2. 扩展 BaseMarketplace 并实现 search() 以及可选的 getListingDetails()

3. 将构造函数添加到 src/marketplaces/index.ts 中的 allMarketplaces

限制

• Facebook：如果 Facebook 更改其前端，可能会失效

• eBay：需要开发者 API 密钥（提供免费套餐）

• Depop：需要安装 Chrome/Chromium；比 Facebook/eBay 慢（每次搜索约 5 秒）

• Poshmark：需要安装 Chrome/Chromium；没有官方 API，因此依赖页面抓取

• 速率限制：不要过快发送过多请求

许可证

MIT