Begagnad MCP

🚀 二手商品MCP服務

二手商品MCP（模型上下文協議）服務是一個用於搜索瑞典兩大二手交易市場——Blocket和Tradera的服務器。它能夠讓Claude等AI智能體在瑞典二手市場中搜索並獲取商品列表，還能返回統一的數據，包括商品標題、描述、價格、圖片、賣家信息以及商品列表的直接鏈接。

🚀 快速開始

利用公共端點

可通過 https://begagnad-mcp.bjesus.workers.dev/sse 訪問即時實例。 通過編輯 ~/.config/Claude/claude_desktop_config.json 來配置Claude桌面端：

{
  "mcpServers": {
    "begagnad": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://begagnad-mcp.bjesus.workers.dev/sse"
      ]
    }
  }
}

重啟Claude桌面端以加載服務器。

部署自己的實例

1. 安裝依賴：

npm install

2. 登錄Cloudflare：

wrangler login

3. 進行部署：

npm run deploy

4. 使用你自己的部署URL更新Claude桌面端配置。

本地開發

npm start

服務器將在 http://localhost:8788/sse 運行。

配置

可以將Tradera API憑證設置為Cloudflare的機密信息：

wrangler secret put TRADERA_APP_ID
wrangler secret put TRADERA_APP_KEY

✨ 主要特性

• 多平臺搜索：支持搜索瑞典兩大二手交易市場Blocket和Tradera。
• 統一數據返回：返回統一的數據結構，涵蓋商品的各項關鍵信息。
• 多工具支持：提供多個工具用於不同的搜索和獲取操作。

📦 安裝指南

上述“快速開始”部分已詳細介紹了使用公共端點、部署自己的實例、本地開發及配置的安裝步驟。

💻 使用示例

基礎用法

向Claude提問，例如：

• "Find me a Linksys router with OpenWRT installed"（幫我找一臺安裝了OpenWRT的Linksys路由器）
• "Search for a red pickup truck under 20000 SEK"（搜索價格低於20000瑞典克朗的紅色皮卡）
• "Show me vintage furniture in Stockholm"（給我看看斯德哥爾摩的復古傢俱）

高級用法

可根據實際需求，結合不同的搜索工具和參數進行更精準的搜索。例如，使用 search_both 工具同時搜索兩個市場，並指定 blocket_limit 參數。

📚 詳細文檔

可用工具

• search_blocket - 搜索Blocket市場
  • 參數：query（字符串），limit（數字，可選）
• get_blocket_item - 獲取特定Blocket商品列表的詳細信息
  • 參數：ad_id（字符串）
• search_tradera - 搜索Tradera市場
  • 參數：query（字符串），page（數字，可選）
• get_tradera_item - 獲取特定Tradera商品列表的詳細信息
  • 參數：item_id（字符串）
• search_both - 同時搜索兩個市場
  • 參數：query（字符串），blocket_limit（數字，可選）

數據格式

返回統一的數據結構：

• 商品ID、標題、描述
• 價格（瑞典克朗）、位置
• 圖片（URL）
• 賣家姓名和評分
• 商品列表的直接鏈接
• 商品來源市場（Blocket或Tradera）

APIs

• Blocket API: https://blocket-api.se/v1/
• Tradera API: https://api.tradera.com/v3/

📄 許可證

本項目採用MIT許可證。