MCP 工具

查询尾料

查询已审核公开的尾料供应信息。

接口标识：material.surplus.search

适用场景

当用户想查找公开尾料库存，并按地区、COA、一对一发票或生产日期范围筛选时使用。

权限和配额

免费账号每日 20 次查询，tds.search、tds.detail、price.search 和 material.surplus.search 共享查询额度；VIP 会员账号不限。

常用参数

字段	类型	说明
keyword	string	必填，2 到 80 个字符，需包含文字或数字。
addr	string	可选，地区或城市筛选。
has_coa	boolean	可选，只返回明确有或无 COA 的记录。
one_to_one_invoice	boolean	可选，只返回明确支持或不支持一对一发票的记录。
production_date_start	YYYY-MM-DD	可选，生产日期起始。
production_date_end	YYYY-MM-DD	可选，生产日期结束。
page	integer	可选，1 到 10，默认 1。
limit	integer	可选，单次最多 10 条，默认 10。

调用示例

json 查询 PA66 尾料

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "material.surplus.search",
    "arguments": {
      "keyword": "PA66",
      "addr": "东莞",
      "has_coa": true,
      "one_to_one_invoice": true,
      "production_date_start": "2026-01-01",
      "production_date_end": "2026-12-31",
      "limit": 5
    }
  }
}

返回结果

返回 items 和 pagination。每条记录包含材料名称、数量、价格、地区、COA、有无一对一发票、生产日期、更新时间和补充说明；历史 COA 或发票字段无法判断时会返回 null 表示未知。

能力边界

查询尾料只返回审核通过、上架、公开可展示的信息，不返回联系方式、供应商身份、审核字段、内部 ID、在线支付或物流信息；补充说明中的联系方式会被隐藏。