Trade Me搜索服务器

一个允许AI助手使用自然语言搜索Trade Me列表的MCP服务器,无需API密钥。

  • by BlueFin605
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 BlueFin605/trademe-mcp

使用说明

Trade Me MCP服务器

MCP(模型上下文协议)服务器,允许AI助手使用自然语言搜索Trade Me列表。不需要API密钥。

设置

先决条件

  • Node.js 18+

安装

cd /path/to/TradeMeMCP
npm install

添加到克劳德代码

创建或编辑 .mcp.json 在项目根目录中(或 ~/.claude/.mcp.json 全球访问):

{
  "mcpServers": {
    "trademe": {
      "command": "npx",
      "args": ["tsx", "/path/to/TradeMeMCP/src/index.ts"]
    }
  }
}

重新启动Claude Code以获取新服务器。

工具

search_trademe

在所有Trade Me市场类别中进行一般搜索——电子产品、服装、收藏品等。

参数: search_string (必填), category, sort_order, condition, price_min, price_max, buy_now, region, page, rows

示例提示:

  • “给我找个200美元以下的二手帐篷”
  • “在惠灵顿搜索PS5控制器”
  • “今天有哪些任天堂Switch游戏上市?”

搜索引擎

在Trade Me Motors中搜索带有品牌/型号/年份过滤的车辆。

参数: search_string, make, model, year_min, year_max, price_min, price_max, odometer_min, odometer_max, transmission, body_style, sort_order, region, page, rows

示例提示:

  • “查找3万美元以下、行驶里程不到10万公里的自动SUV”
  • “给我看看2018年或更新的丰田Hiluxes”

搜索_财产

在Trade Me Property搜索住宅列表。

参数: search_string, price_min, price_max, bedrooms_min, bedrooms_max, bathrooms_min, property_type, district, region, sort_order, page, rows

示例提示:

  • “惠灵顿价值80万美元以下的三居室房屋”
  • “奥克兰待售公寓,带2间以上浴室”

get_list

获取特定列表的完整详细信息,包括描述、照片、卖家信息和出价历史。

参数: listing_id (必填)

示例提示:

  • “显示第一个列表的完整细节”
  • “获取有关列表5858861442的更多信息”

get_类别

浏览Trade Me的类别树,发现类别编号,以便进行更有针对性的搜索。

参数: category_number (可选--顶级类别省略)

示例提示:

  • “Trade Me有哪些类别?”
  • “显示电子产品下的子类别”

提示

  • 新上市: 要求按最新优先排序的结果——该工具支持 StartDateDesc 排序顺序,Claude可以按列表日期进行过滤。
  • 分页: 每页显示25个结果。让克劳德“显示更多”或“下一页”继续浏览。
  • 细化: 你可以通过对话来优化搜索——“更便宜的”、“只在奥克兰”、“只有使用过的条件”。
  • 跨类别: 你不需要知道某样东西在哪个Trade Me部分。只需描述你想要什么。

项目结构

src/
  index.ts          — MCP server setup and tool registration
  api.ts            — Trade Me API client
  formatters.ts     — Response formatting (JSON → readable text)
  tools/
    search.ts       — search_trademe tool
    motors.ts       — search_motors tool
    property.ts     — search_property tool
    listing.ts      — get_listing tool
    categories.ts   — get_categories tool