README
🚀 二手商品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桌面端以加载服务器。
部署自己的实例
- 安装依赖:
npm install
- 登录Cloudflare:
wrangler login
- 进行部署:
npm run deploy
- 使用你自己的部署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许可证。
Scan to join WeChat group