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许可证。