Secondhand MCP

🚀 二手商品MCP

這是一個 模型上下文協議（MCP）服務器，可讓AI助手搜索二手市場。你可以在Facebook Marketplace、eBay、Depop和Poshmark等平臺上搜索二手物品，還能按價格、類別、狀況、尺寸和顏色進行篩選，之後獲取包含照片、描述和賣家信息的完整商品列表詳情。

該服務器可與Claude Desktop、Claude Code、Cursor以及任何兼容MCP的客戶端配合使用。

⚠️ 重要提示

若想跳過設置步驟，可嘗試 二手商品MCP雲服務，這是一個託管版本，能在30秒內連接到Claude.ai和ChatGPT，無需安裝，也不需要Chrome瀏覽器，還提供免費套餐。

✨ 主要特性

• 支持多個二手交易平臺的搜索，包括Facebook Marketplace、eBay、Depop和Poshmark。
• 可根據多種條件進行篩選，如價格、類別、狀況、尺寸和顏色等。
• 能獲取商品的完整詳情，包含照片、描述和賣家信息。
• 與Claude Desktop、Claude Code、Cursor等MCP兼容客戶端集成。

📦 安裝指南

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"
      }
    }
  }
}

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、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使用官方的 瀏覽API，你需要一個免費的eBay開發者賬戶。具體步驟如下：

1. 在 developer.ebay.com 上創建一個賬戶。
2. 創建一個應用程序，獲取客戶端ID和客戶端密鑰。
3. 將它們作為 EBAY_CLIENT_ID 和 EBAY_CLIENT_SECRET 添加到MCP配置中。

工具

search_marketplace

用於在各個平臺上搜索商品，參數說明如下：

各平臺返回的數據字段：

get_listing_details

使用搜索結果中的商品ID獲取特定商品的完整詳情，參數說明如下：

各平臺返回的數據字段：

list_marketplaces

列出所有已啟用的平臺及其狀態。

工作原理

• Facebook Marketplace：通過位置、價格和查詢關鍵詞搜索商品列表，可將城市名稱解析為座標，無需登錄或瀏覽器。
• eBay：使用官方eBay瀏覽API和OAuth 2.0客戶端憑證，令牌會被緩存並自動刷新。
• 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 Marketplace：通過解析城市名稱為座標，利用位置、價格和查詢關鍵詞進行搜索，無需登錄和瀏覽器，直接與前端頁面交互獲取數據。
• eBay：使用官方的Browse API和OAuth 2.0客戶端憑證進行身份驗證和數據請求，令牌會被緩存並自動刷新，以提高性能和減少請求次數。
• Depop：使用無頭瀏覽器（如Chrome或Chromium）模擬用戶操作，通過頁面元素定位和解析來搜索商品列表，支持多種篩選條件。瀏覽器實例在多個請求之間共享，以提高效率。
• Poshmark：同樣使用無頭瀏覽器進行頁面抓取，支持按多種條件篩選商品。由於沒有官方API，主要依賴頁面解析技術來提取數據，且不基於位置信息，所有商品均為全國發貨。

配置與環境變量

• 通過配置文件（如 claude_desktop_config.json 和 .mcp.json）來管理MCP服務器的設置，包括服務器命令、參數和環境變量。
• 環境變量 MARKETPLACES 用於指定要啟用的市場平臺，EBAY_CLIENT_ID 和 EBAY_CLIENT_SECRET 用於eBay API的身份驗證。

代碼結構與模塊化

• 項目採用模塊化設計，將不同市場平臺的實現封裝在 src/marketplaces/ 目錄下的獨立文件中，每個文件繼承 BaseMarketplace 類，並實現相應的搜索和詳情獲取方法。
• 在 src/marketplaces/index.ts 中統一管理所有市場平臺的構造函數，便於擴展和維護。

性能優化與錯誤處理

• 對於eBay的API請求，採用令牌緩存和自動刷新機制，減少不必要的身份驗證請求，提高性能。
• 在使用無頭瀏覽器時，通過共享瀏覽器實例和優化頁面解析邏輯，減少資源佔用和響應時間。
• 對於可能出現的錯誤情況，如缺少API密鑰、未安裝Chrome瀏覽器等，進行了相應的處理和提示，確保系統的穩定性和可用性。

🚫 侷限性

• Facebook：若Facebook更改其前端頁面，可能會導致搜索功能失效。
• eBay：需要開發者API密鑰，不過有免費套餐可供使用。
• Depop：需要安裝Chrome/Chromium瀏覽器，搜索速度比Facebook/eBay慢（每次搜索約5秒）。
• Poshmark：需要安裝Chrome/Chromium瀏覽器，由於沒有官方API，依賴頁面抓取技術。
• 速率限制：請勿過於頻繁地發送大量請求。

📄 許可證

本項目採用MIT許可證。