MCP 工具

查询尾料

通过供应工具查询公开库存;查询尾料时指定 stock_type=surplus。

接口标识:material.supply.search

适用场景

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

权限和配额

免费账号和 VIP 会员账号均可使用,供应发布、查询、管理和联系工具不消耗 MCP 每日查询或购买材料额度,仍受请求限流和访问权限约束。

常用参数

字段 类型 说明
stock_type string 可选,surplus 查询尾料,regular 查询普通料;不传则查询两类供应。
material_category string 可选,engineering_plastic 或 general_plastic。
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.supply.search",
    "arguments": {
      "stock_type": "surplus",
      "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。每条记录包含 supply_id 短 ID、库存类型、材料分类、材料名称、数量、价格、地区、COA、有无一对一发票、生产日期、更新时间和补充说明;历史 COA 或发票字段无法判断时会返回 null 表示未知。可用 supply_id 发起 material.contact.request。

能力边界

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