Jiuyu Shelf MCP · 接入九域货架

通过 MCP 查询一家商店已发布的商品。演示店标识为 demo,可替换为目标商店的标识。

查询报价

只读接口免密钥。search_offers 支持关键词、品类、规格参数和最高价筛选,get_offer 接受上一步返回的 offer_id。

curl -X POST 'https://shelf.jdyysh.net/mcp/demo' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_offers","arguments":{"query":"清洗","limit":5}}}'

在 result.structuredContent.offers 中读取 price、currency、unit 和 source_url。报价条件见 price_note,有效期见 valid_until。expired 为 true 时需向商家重新确认。

每个 IP 每分钟最多提交 60 次 MCP 请求,超限返回 HTTP 429。店铺不存在返回 404;工具错误见 result.isError,协议错误见 error。

通过 HTTP 读取

下载 OpenAPI 描述 · 查看演示店返回值